


SG24-4602-00 

Inside OS/2 Warp Server, Volume 1: 

Exploring the Core Components 

March 1996 




I Take Note! 



Before using this information and the product it supports, be sure to read the general information under 
“Special Notices” on page xix. 



First Edition (March 1996) 

This edition applies to IBM OS/2 Warp Server Version 4. 

Order publications through your IBM representative or the IBM branch office serving your locality. Publications 
are not stocked at the address given below. 

An ITSO Technical Bulletin Evaluation Form for reader's feedback appears facing Chapter 1. If the form has been 
removed, comments may be addressed to: 

IBM Corporation, International Technical Support Organization 
Dept. JN9B Building 045 Internal Zip 2834 
11400 Burnet Road 
Austin, Texas 78758-3493 

When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any 
way it believes appropriate without incurring any obligation to you. 

© Copyright International Business Machines Corporation 1996. All rights reserved. 

Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is 
subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. 





Abstract 



This redbook provides information about the key components of the IBM OS/2 
Warp Server product. Following on the heels of OS/2 Warp Connect, the 
integrated OS/2 client operating system, OS/2 Warp Server combines the 
refreshed OS/2 Warp and LAN Server with a wealth of functional enhancements 
in TCP/IP, Remote Access Services (LAN Distance), systems management 
(SystemView), backup and recovery and advanced print function. Each service 
or function can be selectively installed, allowing users to customize OS/2 Warp 
Server to meet their specific needs. This redbook describes hints and 
workarounds for various installation scenarios. 

The major enhancement to TCP/IP is the dynamic IP introduction. OS/2 Warp 
Server is the first product which has implemented Dynamic DNS (Domain Name 
System) together with DHCP (Dynamic Host Control Protocol). This redbook 
discusses the detail of this protocol and implementation on server and clients. 

Remote Access Services is equivalent to the existing LAN Distance connection 
server product but with several enhancements. This redbook describes not only 
the enhancements but also the basics of remote access services. 

This redbook intends to provide guidance on planning, installation and 
customization of the core components of OS/2 Warp Server. The components 
discussed in this redbook are the File and Print Sharing function with OS/2 and 
DOS/Windows/Windows 95 client, Adapter and Protocol Services, TCP/IP 
Services and Remote Access Services. For information on SystemView in OS/2 
Warp Server, Backup and Recovery, and Advanced Print Services see the 
upcoming redbook, Inside OS/2 Warp Server, Volume 2: Using SystemView , 
Backup/ Recovery and Advanced Print which is planned to be available in 
May/1996. 

Readers are assumed to have some knowledge of OS/2 Warp, IBM OS/2 LAN 
Server 4.0 and basics of TCP/IP protocol and products. 
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Special Notices 



This publication is intended to help IBM systems engineers and customers install 
and configure the core components of the IBM OS/2 Warp Server product. The 
information in this publication is not intended as the specification of any 
programming interfaces that are provided by IBM OS/2 Warp Server. See the 
PUBLICATIONS section of the IBM Programming Announcement for IBM OS/2 
Warp Server for more information about what publications are considered to be 
product documentation. 

References in this publication to IBM products, programs or services do not 
imply that IBM intends to make these available in all countries in which IBM 
operates. Any reference to an IBM product, program, or service is not intended 
to state or imply that only IBM's product, program, or service may be used. Any 
functionally equivalent program that does not infringe any of IBM's intellectual 
property rights may be used instead of the IBM product, program or service. 

Information in this book was developed in conjunction with use of the equipment 
specified, and is limited in application to those specific hardware and software 
products and levels. 

IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594 USA. 

The information contained in this document has not been submitted to any 
formal IBM test and is distributed AS IS. The information about non-IBM 
(VENDOR) products in this manual has been supplied by the vendor and IBM 
assumes no responsibility for its accuracy or completeness. The use of this 
information or the implementation of any of these techniques is a customer 
responsibility and depends on the customer's ability to evaluate and integrate 
them into the customer's operational environment. While each item may have 
been reviewed by IBM for accuracy in a specific situation, there is no guarantee 
that the same or similar results will be obtained elsewhere. Customers 
attempting to adapt these techniques to their own environments do so at their 
own risk. 

Any performance data contained in this document was determined in a 
controlled environment, and therefore, the results that may be obtained in other 
operating environments may vary significantly. Users of this document should 
verify the applicable data for their specific environment. 

Reference to PTF numbers that have not been released through the normal 
distribution process does not imply general availability. The purpose of 
including these reference numbers is to alert IBM customers to specific 
information relative to the implementation of the PTF when it becomes available 
to each customer according to the normal IBM PTF distribution process. 
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Preface 



This redbook describes the core functions of the IBM OS/2 Warp Server product, 
based on the experiences of the systems engineers who participated in the ITSO, 
Austin Center, project. 

The purpose of this redbook is to provide guidance on installing and configuring 
the core IBM OS/2 Warp Server components. This document does not describe 
the systems management, backup and restore, software distribution and 
advanced print services components of IBM OS/2 Warp Server. A separate 
redbook Inside OS/2 Warp Server, Volume 2: Using SystemView, 

Backup/ Recovery and Advanced Print is planned to be available in May/1996. 
Knowledge of IBM OS/2 Warp and IBM OS/2 LAN Server 3.0 or 4.0, and an 
understanding of TCP/IP are assumed. 



How This Document is Organized 

The document is organized as follows: 

• Chapter 1, “OS/2 Warp Server Version 4 Product Information” 

This chapter introduces a summary of OS/2 Warp Server. 

• Chapter 2, "File and Print Sharing Services” 

The primary function of OS/2 Warp Server is to provide the ability to share 
resources. This chapter discusses how file and print resources are shared 
and how to tune your OS/2 Warp Server environment. In addition the chapter 
discusses how you may access the resources of other file sharing 
environments from an OS/2 Warp Server client by using OS/2 Warp Server 
as a gateway. 

• Chapter 3, “File and Print Clients” 

OS/2 Warp Server provides support for all prevalent network clients. This 
chapter describes each client in detail and includes specific information on 
the new Windows 95 client. 

• Chapter 4, “Adapter and Protocol Services” 

This chapter explains how to install and configure Adapter and Protocol 
Services and how to use the new and advanced features of this key 
component of OS/2 Warp Server. 

• Chapter 5, “TCP/IP Services” 

This chapter describes the TCP/IP functions provided with OS/2 Warp Server 
and specifically concentrates on the new dynamic IP capabilities. 

• Chapter 6, “NetBIOS over TCP/IP {TCPBEUI)” 

This chapter covers all of NetBIOS over TCP/IP functions or TCPBEUI issues 
in both static and dynamic IP environment. 

• Chapter 7, “Remote Access Services" 

The Remote Access Services component of OS/2 Warp Server allows 
multiple concurrent remote OS/2 and Windows workstations to connect to a 
LAN and operate as if locally attached. This chapter discusses the 
installation, configuration and advanced features of Remote Access Services. 
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• Appendix A, “Remote Access Services Internal Architecture” 

This appendix includes some information on the internal design and 
architecture of the Remote Access Services. You do not require a detailed 
understanding of the internal structure of the Remote Access Services to 
install and use it. The information presented here can prove valuable to 
people who are using Remote Access Services in an advanced environment. 



Related Publications 

The publications listed in this section are considered particularly suitable for the 
topics covered in this document. 

• OS/2 Warp Server Version 4 Easy Start, S25H-8003 

• OS/2 Warp Server Version 4 Up and Running!, S25H-8004 

• OS/2 LAN Server Network Administrator Reference, Volume 1: Planning, 
Installation, and Configuration, SI 0H-9680 

• OS/2 LAN Server Network Administrator Reference, Volume 2: Performance 
Tuning, S10H-9681 

• OS/2 LAN Server Network Administrator Reference, Volume 3: Network 
Administrator Tasks, S10H-9682 

• LAN Server Command and Utilities, S10H-9686 

• IBM LAN Distance Remote Guide, S52G-8393 

• IBM LAN Distance Advanced Guide, S52G-8394 

• IBM Multi-Protocol Transport - AnyNet for OS/2: Configuration Guide, 
S25H-7867 

• LAN Technical Reference IEEE 802.2 and NETBIOS APIs, SC30-3587 

• TCP/IP for OS/2 V2.0 Installation and Administration , SC31-6075 

• IBM TCP/IP Version 2.0 for OS/2 Domain Name Server Guide, SC31-7174 

The following list of books are available from book stores and are useful for 
understanding TCP/IP and Internet: 

• Internetworking with TCP/IP Volume 1 by Douglas E. Comer 

• The Whole Internet User's Guide and Catalog by Ed Krol 

• The Internet for Dummies by John R. Levine and Carol Baroudi 

• Your OS/2 Warp Internet Connection by Deborah Morrison 



International Technical Support Organization Publications 

• Inside OS/2 Warp Server, Volume 2: Using SystemView, Backup/ Recovery and 
Advanced Print, SG24-4702 (to be available in May/96) 

• Inside OS/2 LAN Server 4.0, SG24-4428 

• OS/2 Warp Generation, Volume 1: OS/2 Warp Version 3, OS/2 Warp with 
Windows and BonusPak, SG24-4552 

• OS/2 Warp Generation, Volume 2: Exploring LAN Connectivity with OS/2 
Warp Connect, GG24-4505 

• TCP/IP V2.0 for OS/2 Installation and Interoperability, GG24-3531 
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• Understanding IBM OS/2 LAN Server Performance Tuning, GG24-4430 

• NetWare Client for OS/2 Installation and Configuration, GG24-3891-01 

• IBM LAN Distance Version 1.1 Configuration and Customization Guide, 
GG24-41 58-01 

A complete list of International Technical Support Organization redbooks, with a 
brief description of each, may be found in: 

International Technical Support Organization Bibliography of Redbooks, 
GG24-3070. 

To get a catalog of ITSO redbooks online, VNET users may type: 

TOOLS SENDTO WTSCPOK TOOLS REDBOOKS GET REDBOOKS CATALOG 

A listing of all redbooks, sorted by category, may also be found on MKTTOOLS 
as ITSOCAT TXT. This package is updated monthly. 



How Customers Can Get Redbooks and Other ITSO Deliverables 

Customers may request ITSO deliverables (redbooks, BookManager BOOKs, and 
CD-ROMs) and information about redbooks, workshops, and residencies in the 
following ways: 

• IBMUNK 

Registered customers have access to PUBORDER to order hardcopy, to 
REDPRINT to obtain BookManager BOOKs 

• IBM Bookshop — send orders to: 

usib6fpl@ibmmail.com (USA) 
bookshop@dk.ibm.com (Outside USA) 

• Telephone orders 

1-800-879-2755 (USA) 

354-9408 (Australia) 

359-2-731076 (Bulgaria) 

42-2-67106-250 (Czech Republic) 

593-2-5651-00 (Ecuador) 

03-69-78901 (Israel) 

905-627-1163 (Mexico) 

064-4-57659-36 (New Zealand) 

027-011-320-9299 (South Africa) 

• Mail Orders — send orders to: 

IBM Publications 
P.O. Box 9046 
Boulder, CO 80301-9191 
USA 

• Fax — send orders to: 

1-800-445-9269 (USA) 

32-2-225-3478 (Belgium) 

905-316-7210 (Canada) 

593-2-5651-45 (Ecuador) 

03-69-59985 (Israel) 

31-20513-3296 (Netherlands) 



0256-478166 (UK) 
32-2-225-3738 (Belgium) 
1-800-IBM-CALL (Canada) 
45-934545 (Denmark) 
01805-5090 (Germany) 
0462-73-6669 (Japan) 
31-20513-5100 (Netherlands) 
507-639977 (Panama) 



IBM Direct Services 
Sortemosevej 21, 
3450 Allerod 
Denmark 



0256-843173 (UK) 

359-2-730235 (Bulgaria) 
42-2-67106-402 (Czech Republic) 
07032-15-3300 (Germany) 
0462-73-7313 (Japan) 
064-4-57659-16 (New Zealand) 
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507-693604 (Panama) 



027-01 1 -320-9113 (South Africa) 



• 1-800-IBM-4FAX (USA only) - ask for: 

index # 4421 Abstracts of new redbooks 

Index # 4422 IBM redbooks 

Index # 4420 Redbooks for last six months 

• Direct Services 

Send note to softwareshop@vnet.ibm.com 

• Redbooks Home Page on the World Wide Web 

http : //www. redbooks . i bm. com/redbooks 

• E-mail (Internet) 

Send note to redbook@vnet.ibm.com 

• Internet Listserver 

With an Internet E-mail address, anyone can subscribe to an IBM 
Announcement Listserver. To initiate the service, send an E-mail note to 
announce@webster.ibm1ink.ibm.com with the keyword subscribe in the body of 
the note (leave the subject line blank). A category form and detailed 
instructions will be sent to you. 



How IBM Employees Can Get Redbooks and ITSO Deliverables 

Employees may request ITSO deliverables (redbooks, BookManager BOOKS, and 
CD-ROMs) and information about redbooks, workshops, and residencies in the 
following ways: 

• PUBORDER — to order hardcopies in USA 

• GOPHER link to the Internet 

Type GOPHER 

Select IBM GOPHER SERVERS 

Select ITSO GOPHER SERVER for Redbooks 

• Tools disks 

To get LIST3820s of redbooks, type one of the following commands: 

TOOLS SENDTO EH0NE4 T00LS2 REDPRINT GET GG24xxxx PACKAGE 

TOOLS SENDTO CANVM2 TOOLS REDPRINT GET GG24xxxx PACKAGE (Canadian users on 

To get lists of redbooks: 

TOOLS SENDTO WTSCPOK TOOLS REDBOOKS GET REDBOOKS CATALOG 
TOOLS SENDTO USDIST MKTTOOLS MKTTOOLS GET ITSOCAT TXT 
TOOLS SENDTO USDIST MKTTOOLS MKTTOOLS GET LISTSERV PACKAGE 

To register for information on workshops, residencies, and redbooks: 

TOOLS SENDTO WTSCPOK TOOLS ZDISK GET ITSOREGI 1996 

For a list of product area specialists in the ITSO: 

TOOLS SENDTO WTSCPOK TOOLS ZDISK GET ORGCARD PACKAGE 

• Redbooks Home Page on the World Wide Web 

http : //w3 . i tso. i bm. com/ redbooks /redbooks . html 

• ITS04USA category on I NEWS 
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• IBM Bookshop — send orders to: 

USIB6FPL at IBMMAIL or DKIBMBSH at IBMMAIL 

• Internet Listserver 

With an Internet E-mail address, anyone can subscribe to an IBM 
Announcement Listserver. To initiate the service, send an E-mail note to 
announce@webster.ibtnlink.ibm.com with the keyword subscribe in the body of 
the note (leave the subject line blank). A category form and detailed 
instructions will be sent to you. 



Acknowledgments 

This project was designed and managed by: 

Oscar Cepeda ITSO, Austin Center 

Toshi Shimizu ITSO, Austin Center 



The authors of this document are as follows: 



Geraldo Macedo 
Martin Murhammer 
Indran Naick 
Emmanuel Odier 
Hermann Pauli 
Alain Rykaert 
Andrew Taylor 
Enrique Testini 
Colin Vernon 
Uwe Zimmermann 



IBM Brazil 
IBM Austria 
IBM South Africa 
IBM France 
IBM Germany 
IBM Belgium 
IBM United Kingdom 
IBM Italy 

IBM United Kingdom 
ITSO, Austin Center 



This publication is the result of a residency conducted at the International 
Technical Support Organization, Austin Center. 

Thanks to the following people for their invaluable advice and help provided in 
the production of this document: 

• IBM Austin 

Paul Carson 
Gary Hunt 
Don Mu Ivey 
Jim Pickering 
Doug Spelce 
Steve Tipton 
Galen Watson 
Ken Whitfield 

• IBM Raleigh 

Bryan Frey 
Danielle Moore 
Glenn Stump 
Wendy White 

• Other companies 

Brice Bartek, Network Telesystems, Inc. 

Linda De Los Reyes, RSA Inc. 



Preface 



XXV 





XXVI inside OS/2 Warp Server, Volume 1 




ITSO Technical Bulletin Evaluation 
SG24-4602-00 



REDOOO 




Fold and Tape Please do not staple Fold and Tape 




BUSINESS REPLY MAIL 

FIRST CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK 



POSTAGE WILL BE PAID BY ADDRESSEE 



IBM International Technical Support Organization 

Department JN9B, Building 045 

Internal Zip 2834 

11400 BURNET ROAD 

AUSTIN TX 

USA 78758-3493 






Fold and Tape 



Please do not staple 



Fold and Tape 



SG24-4602-00 





ITSO Technical Bulletin Evaluation 



RED000 



Inside OS/2 Warp Server, Volume 1: 

Exploring the Core Components 

Publication No. SG24-4602-00 

Your feedback is very important to help us maintain the quality of ITSO Bulletins. Please fill out this 
questionnaire and return it using one of the following methods: 

• Mail it to the address on the back (postage paid in U.S. only) 

• Give it to an IBM marketing representative for mailing 

• Fax it to: Your International Access Code + 1 914 432 8246 

• Send a note to REDBOOK@VNET.IBM.COM 

Please rate on a scale of 1 to 5 the subjects below. 

(1 = very good, 2 = good, 3 = average, 4 = poor, 5 = very poor) 



Overall Satisfaction 

Organization of the book 
Accuracy of the information 
Relevance of the information 
Completeness of the information 
Value of illustrations 



Grammar/punctuation/spelling 
Ease of reading and understanding 
Ease of finding information 
Level of technical detail 
Print quality 



Please answer the following questions: 

a) If you are an employee of IBM or its subsidiaries: 





Do you provide billable services for 20% or more of your time? 


Yes 


_ No 




Are you in a Services Organization? 


Yes 


_ No 


b) 


Are you working in the USA? 


Yes 


_ No 


c) 


Was the Bulletin published in time for your needs? 


Yes 


No 


d) 


Did this Bulletin meet your needs? 


Yes 


No 



If no, please explain: 



What other topics would you like to see in this Bulletin? 



What other Technical Bulletins would you like to see published? 



Comments/Suggestions: 


( THANK YOU FOR YOUR FEEDBACK! ) 


Name 


Address 


Company or Organization 



Phone No. 








Chapter 1. OS/2 Warp Server Version 4 Product Information 



OS/2 Warp Server, Version 4, is IBM's one-box server operating system solution 
for customers ranging from small and medium-sized businesses to large 
enterprises. It combines a foundation for application serving with integrated file 
and print sharing, and offers an easy-to-use graphical user interface for 
drag-and-drop administration. 

Following on the heels of OS/2 Warp Connect, IBM's network client operating 
system, OS/2 Warp Server combines the market-proven quality of OS/2 Warp 
and LAN Server 4.0 with a wealth of functional enhancements in systems 
management, backup and recovery, remote access, enhanced TCP/IP support, 
advanced print function, and LAN Internet access. All services are integrated 
into the product, eliminating the time and cost of having to separately install 
each component. However, services such as file and print can be selectively 
installed, allowing users to customize OS/2 Warp Server to meet their specific 
needs. The installation procedure also includes auto-detection of devices such 
as network interface cards. 










OS/2 System 

LAN Services File and Print 
NetWare File and Print Gateway Services 
TCP/IP Services 

LAN Distance Remote Access Services 
SystemView System Management Services 
PSnS - Backup and Recovery Services 
PSF/2 Advanced Print Services 



Figure 1 . OS/2 Warp Server Product Components 



1.1 A Powerful Server 

OS/2 Warp Server inherits from LAN Server 4.0 a sophisticated set of network 
capabilities, including an easy-to-use drag-and-drop administration model which 
allows network administrators and resellers to quickly install, set up, configure 
and manage a network. It offers tight security that is flexible enough to be 
customized to the needs of any business by assigning various privileges down to 
specific files on the server. OS/2 Warp Server also uses a powerful high 
performance file system and includes a NetWare migration utility that will allow 
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an organization to migrate NetWare 2.x and 3.x users and information onto an 
OS/2 Warp Server environment using a graphical user interface. 

OS/2 Warp Server possesses the same 32-bit, preemptive multitasking 
capabilities of IBM's powerful and battle-tested OS/2 Warp operating system, and 
comes Internet-ready with IBM's popular Internet Access Kit and WebExplorer. It 
offers reliable crash protection, runs OS/2 and DOS applications and contains 
IBM's WIN-OS/2 code, which provides support for 16- and 32-bit Windows 
applications. 



1.2 For Businesses of All Sizes 

With sophisticated, easy-to-use networking components on a powerful operating 
system platform, OS/2 Warp Server will appeal to a diverse set of market 
segments, from small and medium sized businesses to departmental corporate 
workgroups to large businesses and institutions. Resellers and VARs are also 
an important target audience for OS/2 Warp Server. Not only do they stand to 
benefit from selling a complete business solution to such a broad set of users, 
but their job is made easier with OS/2 Warp Server's outstanding system 
management capabilities. 



1.3 Broad Client Support 

OS/2 Warp Server supports ail prevalent network clients, including OS/2 Warp 
and OS/2 Warp Connect, DOS, Windows 3.x, Windows NT Workstation, Windows 
for Workgroups and Windows 95. Macintosh clients are supported via IBM's LAN 
Server for Macintosh add-on product and AIX clients are supported via IBM's PC 
Connection product, both available separately. OS/2 Warp Server is backward 
compatible with previous IBM LAN Server clients. This will allow OS/2 Warp 
Server servers to be incrementally added to an existing LAN Server network and 
will provide the customer with complete compatibility between systems. OS/2 
Warp Server also supports gateway functionality to Novell NetWare and 
Microsoft NT and LAN Manager servers, allowing OS/2 Warp Server clients to 
access non-OS/2 Warp Server resources. 



1.4 Enhanced TCP/IP Connectivity 

Equipped with new features such as Dynamic Host Configuration Protocol 
(DHCP) and Dynamic Domain Name Services (DDNS) servers and a NetBIOS 
over TCP/IP implementation that allows customers to connect up to a thousand 
client workstations, OS/2 Warp Server can share its power with systems in a 
heterogeneous environment. As TCP/IP is becoming more and more popular, 
OS/2 Warp Server delivers exciting new functions to the world of TCP/IP users. 

Network administrators face a host of challenges building and maintaining their 
TCP/IP networks. Typically, they must assign IP (internet protocol) addresses, 
host names, and other network information at individual computers. This forces 
them to track changes every time a computer is either added, removed or 
relocated in the network. Users or administrators must also manually configure 
computers for network access. These tasks are time-consuming, error prone, 
and can disrupt network operations. IBM has addressed these challenges with a 
new networking technology called Dynamic IP. 
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IBM is introducing Dynamic IP in OS/2 Warp Server. Dynamic IP implements a 
true TCP/IP plug-and-go network solution, greatly simplifying both IP network 
access and IP network administration. Furthermore, Dynamic IP is well-suited 
for networking mobile hosts and is fully compatible and interoperable with 
existing IP network hosts and routers. 

Dynamic IP is the integration of the Dynamic Host Configuration Protocol (DHCP) 
and Dynamic Domain Naming System (DDNS). Both DHCP and Dynamic DNS 
are new features to OS/2 Warp Server, and Dynamic DNS is a first in the 
industry. 

DHCP and DDNS are complementary open networking standards developed by 
the IETF (Internet Engineering Task Force) which assures compatibility with 
clients and servers on other operating systems, including UNIX, Windows NT, 
and Windows 95. Each protocol implements half of the TCP/IP plug-and-go 
network solution. The DHCP protocol centralizes and automates the 
configuration of IP hosts, including IP addresses, while the Dynamic DNS 
protocols automatically record the association between IP hosts and their 
DHCP-assigned addresses. 

Using DHCP and DDNS, a host automatically configures itself for network access 
wherever it plugs-in to the IP network. That host can then be located and 
accessed using its permanent, unique DNS host name. Mobile hosts, for 
example, can therefore freely move about a network without knowledge of the 
local IP network addresses or services and without end-user or administrator 
intervention. 

The OS/2 Warp Server software package includes a Dynamic IP client, a DHCP 
server, and a Dynamic DNS Server. The Dynamic IP client consists of both a 
DHCP and a Dynamic DNS client component. The DHCP client may be 
configured to operate as a simple DHCP client or as a Dynamic IP client, 
integrating Dynamic DNS client services with the DHCP client. 

The Dynamic DNS server is a superset of the industry-standard BIND DNS server 
and may be configured to operate as a traditional static DNS server or a new 
Dynamic DNS server, or both. 

The capability of transmitting the NetBIOS application protocol over TCP/IP 
networks enables OS/2 Warp Server to be accessed across geographically 
dispersed system environments as well as in local area networks (LANs). This 
function is also based on open standards (RFCs 1001/1002) to ensure 
compatibility with a wide range of clients and servers using NetBIOS over 
TCP/IP. 



1.5 Sophisticated Systems Management Made Easy 

To address the challenges faced by today's network administrators, OS/2 Warp 
Server will contain systems management features which ensure a high degree of 
performance and reliability. Administrators will be able to remotely manage 
computers across the network, allowing them to quickly address network issues 
by monitoring or even taking control of any computer on a LAN without leaving 
their desk. 

OS/2 Warp Server provides a software and hardware discovery feature for 
system administrators, giving network supervisors the ability to determine the 
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exact components of any PC on the network. System administrators will be able 
to determine such components as software titles, version number of programs, 
type of configuration, type and size of hard disk drive, amount of system memory 
and network interface card. This will help administrators identify software 
upgrades, detect system incompatibilities and determine the need for hardware 
upgrade components. By having the ability to do all of this without leaving their 
desks, administrators will be able to manage their systems much more easily 
and efficiently, reducing the cost of LAN management. 

As a preventive measure, on-screen alerts built into OS/2 Warp Server will warn 
administrators of predictive hardware failures such as low disk space and 
exceeding the CPU threshold. This is an added benefit to resellers because it 
helps them avoid potential customer satisfaction problems. 

Details of the system management and software distribution features of OS/2 
Warp Server may be found in Inside OS/2 Warp Server, Volume 2: Using 
SystemView, Backup/ Recovery and Advanced Print which is planned to be 
available in May 1996. 



1.6 Carefree System Backup and Recovery 

Reliable protection from data loss is vital for any business employing a network. 
IBM has implemented a comprehensive backup and recovery system in OS/2 
Warp Server that eliminates the worry. Utilizing object-oriented administration 
and an intuitive interface, OS/2 Warp Server offers an easy-to-use, yet 
sophisticated, backup solution. 

OS/2 Warp Server users will be able to schedule full or partial data backups to a 
variety of media formats including diskette, tape and optical drives. An 
advanced disaster recovery feature is included that will allow a business to 
recover vital data, even in the event of a complete server hard disk crash. Users 
will also have the unique ability to load tape backups and restore information to 
the network without loading the core operating system, allowing them to easily 
and painlessly recover data and get their business up and running again very 
quickly. 

This integrated backup facility is also compatible with IBM's Adstar Distributed 
Storage Manager (ADSM), which allows users to manage data centrally on a 
variety of IBM and non-IBM platforms, including DEC, Apple, Hewlett-Packard, 
Sun, Novell and Windows, as well as IBM's MVS, VM, VSE, AIX and AS/400 
environments. This scalability across platforms protects investments and 
creates an efficient heterogeneous operating environment. 



1.7 Remote Access 

Remote connectivity is a need for businesses of all sizes today, and OS/2 Warp 
Server features a full set of remote access capabilities. Organizations ranging 
from small businesses with two sites across town to multinational corporations 
can now quickly access vital information via this integrated remote functionality. 

With OS/2 Warp Server's remote node capability, users are able to log onto the 
network, upload and download data and print documents to other facilities. 
Offices will be able to quickly share information by linking to their corporate 
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network and other sites via a high speed modem line, X.25 or ISDN. Mobile 
users can connect to the office as though they were sitting at their desks. 

In addition, OS/2 Warp Server's remote control feature reduces the cost of 
support. A system administrator or reseller will actually be able to see what the 
user sees, extending the ability to reach out and view, troubleshoot and solve 
network issues from across town or from thousands of miles away. 



1.8 Advanced Print Functionality 

Printing over the network is an important task for organizations of all sizes. 

OS/2 Warp Server includes new printing enhancements that will solve various 
needs for a variety of customers. With OS/2 Warp Server's postscript printer 
emulation, users are able to send postscript documents to non-PostScript laser 
printers such as Hewlett-Packard and LexMark, saving both time and money. 

OS/2 Warp Server also has advanced printer functionality that is compatible with 
high speed host printers in a mainframe connected environment. This 
compatibility will greatly assist organizations by protecting their investments in 
high-capacity host printers. A corporate customer can easily introduce OS/2 
Warp Server into the network and configure this advanced business network 
solution to drive 300 page per minute printers, again saving much time and 
money. 

Details of the advanced print features of OS/2 Warp Server may be found in 
Inside OS/2 Warp Server, Volume 2: Using SystemView, Backup/ Recovery and 
Advanced Print which is planned to be available in May 1996. 



1.9 Two Versions of OS/2 Warp Server 

OS/2 Warp Server is available in two versions: 

• OS/2 Warp Server Version 4, which includes ail of the features already 
mentioned and supports approximately 120 users for file and print sharing 
and 1,000 users for application serving. 

• OS/2 Warp Server Advanced Version 4, which includes the same features, 
plus fault tolerance, enhanced Pentium optimization and user disk limits. 
The Advanced version includes 32-bit High Performance File System for 
higher performance file and print sharing and Lotus Notes usage, and 
supports up to 1,000 users on a single server. 
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Chapter 2. File and Print Sharing Services 



The File and Print Sharing Services component of OS/2 Warp Server is a local 
area network (LAN) application which is functionally equivalent to OS/2 LAN 
Server 4.0 with Service Pack IP08152 applied. It allows you to share hardware 
and software resources that are located on a server workstation. 

You may share the directories (and the applications and files contained in them) 
and the printers and serial devices (such as a modem or plotter) that are 
connected to the server workstation. These shared resources are also referred 
to as network resources. 

From a workstation, after you have connected to a network resource, you may 
use that resource in the same way you use local resources. 

Note: DOS and Windows clients may not access shared serial devices unless 
they are redirected to LPT ports for output only (serially attached printers and 
plotters for example). 



2.1 Overview 

When you open the IBM LAN Services folder, the following File and Print Sharing 
Services functions are available. 



iy.LAN Services Pile and Print - Icon View 



Start Server 



Logon 



logoff 



LAN Server 
Administration 

LAN Server 
Audit Log Utility 

LAN Server 
Error Log Utility 

Warp Server Tuning Assistant 
Network Messaging 



Network DDE 
y) and Clipboard 

OS/2 LAN Services 
Installation/Configuration 



pfl Adapters and Protocol Services 
p|j|p FT Setup 
JH FT Administration 



Create 386 HPFS OS/2 
W Startup Diskette 

ERROR. TXT 



README.DOC 



k^xvvv:-;: 









Figure 2. IBM LAN Services Folder 

Each object, as shown in Figure 2, represents a specific function: 

• Start Server 

Select this object to start the File and Print Sharing Services on the server 
workstation if you did not select to automatically start the server using the 
changes applied to STARTUP.CMD as part of the installation process. 

• Logon 
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Allows you to perform domain logon and local logon {for subsystems 
requiring local verification). OS/2 Warp Server does not require local logon. 

• Logoff 

Allows you to log off the domain. Make sure all network applications are 
closed before logging off otherwise you will need to confirm that you wish to 
terminate each individual network application and all associated 
connections. 

• LAN Server Administration 

Allows you to administer a network running OS/2 Warp Server. Whether or 
not you are already familiar with manipulating objects in OS/2 2.x you will 
find it very easy to administer your OS/2 Warp Server environment by simply 
dragging and dropping objects to manage users, groups, and shared 
resources. We take a look at the OS/2 Warp Server Administration GUI in 
2.6, “Sharing Resources with the Administration GUI” on page 19. 

• LAN Server Audit Log Utility 

This is where you look to view OS/2 Warp Server events and other events 
that you have defined to be logged. You will notice that any changes you 
make to the sort order will be saved and retrieved every time you view the 
Audit Log. This is an enhancement to LAN Server 4.0 (prior to IP08152). 

• LAN Server Error Log Utility 

If you experience problems starting your OS/2 Warp Server, or see any 
errors during operation, then this utility will identify the problem and provide 
advice on what you should do to resolve it. You will notice that any changes 
you make to the sort order will be saved and retrieved every time you view 
the Error Log. This is an enhancement to LAN Server 4.0 (prior to IP08152). 

• IBM OS/2 Warp Server Tuning Assistant 

Provides automatic tuning and configuration of your OS/2 Warp Server. We 
will look at this feature in detail in 2.5, “OS/2 Warp Server Tuning Assistant” 
on page 15. 

• Network Messaging 

Selecting this object enables you to send messages to, and receive 
messages from, users on the network. 

• Network DDE and Clipboard 

You can use this function to cut and paste data into other applications on the 
network using dynamic data exchange (DDE) and Clipboard functions. 

• OS/2 LAN Services Installation/Configuration 

You would use this function to reinstall, reconfigure or remove the File and 
Print Sharing Services function from the local workstation. It also provides 
you with the option to create response files (for CID installation). See 
Figure 33 on page 32. 

• Adapters and Protocol Services 

Allows you to configure PROTOCOL.INI file parameters for the protocol(s) 
and NDIS driver(s) on the workstation. Refer to the online MPTS/2 books 
and Chapter 4, "Adapter and Protocol Services” on page 125 for further 
information. 



8 Inside OS/2 Warp Server, Volume 1 




Note: When modifying the MPTS/2 configuration you must use this object. 
Using the MPTS/2 object on the OS/2 Warp Server Desktop will not update 
the netx statement(s) in the File and Print Sharing Services configuration file 
(IBMLAN.INI). 

Fault Tolerance Setup 

Provides the FTSETUP utility to set up Fault Tolerance on the network for the 
first time. OS/2 Warp Server File and Print Sharing Services provides the 
following fault tolerance features: 

— Drive mirroring 

The ability to duplicate a single logical drive or volume on two partitions 
which are on different disks. This protects you against a single drive 
failure. 

- Drive duplexing 

Providing further protection by imposing a restriction that the two disks 
on which the partitions reside are controlled by two different disk 
controllers. This protects you against both single drive failure and single 
disk controller failure. 

Fault Tolerance Administration 

Provides the FTADMIN utility to manage Fault Tolerance on the network. 

Notes: 

1. Fault Tolerance functions are not available with the OS/2 Warp Server 
Entry package. 

2. Fault Tolerance functions are not automatically installed with File and 
Print Sharing Services. You must specify that you wish to install them by 
selecting the appropriate check box as shown in Figure 5 on page 12. 

Create 386 HPFS OS/2 Startup Diskette 

The OS/2 Warp Server Advanced package uses a highly optimized derivative 
of the OS/2 Warp high performance file system {HPFS). When a partition is 
formatted for 386 HPFS you will not be able to access files on that partition 
unless the 386 HPFS installable file system (IFS) driver is loaded. Therefore, 
to access a system which does not have a valid CONFIG.SYS file you need to 
boot from the OS/2 Warp Installation Diskette and a backup copy of the OS/2 
Warp Diskette 1 which has been modified by this utility to include the 386 
HPFS file system driver. 

Note: If you experience problems with the 

\IBMLAN\NETPROG\WSBOOT.CMD utility, check the volume label of your 
OS/2 Warp Server CD-ROM 1. If the volume label is WARP SERVER (with 
underscore please alter line 54 of the the REXX command file 
appropriately. 

IBMRAID.ADD 

For server machines based on RAID technology, be sure to have the 
IBMRAID.ADD driver copied onto the modified OS/2 Warp Diskette 1. 

Also, the following line must be appended as line one to the CONFIG.SYS 
file: 

BASEDEV=IBMRAID . ADO 

For more information, see “Installation Considerations” on page 13. 
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As previously mentioned, OS/2 Warp Server shares much in common with the 
LAN Server 4.0 package. For a thorough discussion of the above features please 
refer to the red book Inside OS/2 LAN Server 4.0. 

In this chapter we will cover in detail the tasks that you are likely to want more 
information on as you start sharing resources in an OS/2 Warp Server 
environment. 



2.2 OS/2 Warp Server Domain Concept 

Before we take a look at the File and Print Sharing Services provided with OS/2 
Warp Server it is important that you understand the concept of a domain. It is 
very likely that you will want to share the resources located on more than one 
server workstation in your OS/2 Warp Server environment. 

A domain is a named network consisting of a group of workstations linked 
together to share resources such as directories, printers, modems and plotters. 
You logon to an OS/2 Warp Server domain and gain access to shared resources 
which may be located on a number of server workstations in the domain. To the 
user it appears as though they are connected to a single server and they are 
unaware that they are accessing resources which may be located on different 
servers. They are presented with a single system image. 

Each domain consists of the following types of workstations: 

• There is always one, and only one, primary server workstation called the 
domain controller that maintains the master copies of the user and group 
definitions. The domain controller also has details of access permissions 
that users and groups have to use shared resources and also how they 
appear to them when they log on. 

The domain controller processes user's logon requests and may also share 
it's own resources. 

• Optionally, additional server workstations may be installed to provide shared 
resources and to serve as backup domain controllers. Backup domain 
controllers support the domain controller in processing logon requests and 
can take over the role of the domain controller should it fail. 

• Requesters, from which users can access shared resources on the server 
workstations. We look at the various requesters that may be used with OS/2 
Warp Server in Chapter 3, “File and Print Clients" on page 49. 

This is a high level overview of domains. For a more detailed discussion please 
refer to the OS/2 Warp Server publication named Up <& Running!. 

For an in-depth explanation of the backup domain controller's function in a 
domain please refer to the redbook Inside OS/2 LAN Server 4.0. 



2.3 Installation 



File and Print Sharing Services is obviously the key component of OS/2 Warp 
Server and is therefore presented as the first component available to install as 
shown in Figure 4 on page 12. 

Detailed step by step installation instructions are provided in the OS/2 Warp 
Server Easy Start publication. Therefore, we will only look at certain aspects of 
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the File and Print Sharing Services installation process that perhaps require 
further clarification. 




Figure 3. Welcome to OS/2 Warp Server Installation 

One of the first screens that you are presented with is shown in Figure 3. 
Information that you provide here will be used, particularly by File and Print 
Sharing Services, to automatically generate the default user ID and server name, 
both from Last name and domain name, based on Department. 

Note: You are obviously provided with options to change the server and domain 
name. What is new to OS/2 Warp Server is the option to specify the user ID and 
password of the initial administrator. In OS/2 LAN Server you were provided 
with an initial administrator user ID and password of USERID and PASSWORD 
respectively which obviously had security implications if you forgot to delete this 
ID or change the password after creating another administrator ID. 



Chapter 2. File and Print Sharing Services 11 













Figure 4. OS/2 Warp Server Component Installation 

Selecting More... provides you with the option to select the specific File and Print 
Sharing Services features that you would like to install. 
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□ NetWare File and Print Gateway Service 

□ Remote Boot Service for OS/2 Workstations (Remote iPL) 
~i Remote Boot Service for DOS Workstations (Remote IPL) 
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OK 



■ Cancel 1 

&&&&& 



Help ' \ 










• 1 

|||1 i 



Figure 5. File and Print Sharing Services Feature Installation 

Each feature of File and Print Sharing Services is well documented in the online 
OS/2 Warp Server documentation and in OS/2 LAN Server publications so we 
will not discuss them in detail. 
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Installation Considerations 

If you are using nonstandard hardware such as RAID technology or non-IBM 
CD-ROM drives, you need to copy necessary files to the second diskette and 
make necessary changes in the CONFIG.SYS file. Failure to do so might result 
in not being able to see devices when starting your workstation from boot 
diskettes. 

Enabling RAID Support 

1. For server machines based on RAID technology, be sure to have the latest 
IBMRAID.ADD driver. 

a. Internet users may retrieve that file from the IBM Personal Computer 
Servers homepage. Point your WEB browser to the following URL: 

http://www.pc.ibm.com/server 

At the end of that page there is a RAID support item in the Files section 
from where you can get the latest IBMRAID.ADD file. 

b. Alternatively, instead of IBMRAID.ADD, you may use the DAC960.ADD 
file which comes with OS/2 Warp Server. This files resides on the 
CD-ROM's \WARPSRV\IBMRAID subdirectory and is an updated 
replacement for IBMRAID.ADD. 

2. Append the following line and make this line the first statement in the 
CONFIG.SYS file of the second boot diskette: 

BASEDEV=I BMRAI D . ADD 

Note: If you chose DAC960.ADD as your RAID driver, you would insert the 
line BASEDEV=DAC960 . ADD instead. 

After OS/2 Warp Server installation, the RAID driver resides in the root directory. 
You may want to move that file to the \OS2\BOOT directory. 



2.4 Configuration 

The configuration process of the File and Print Sharing Services component of 
OS/2 Warp Server should be familiar to you if you have previously installed OS/2 
LAN Server. The panels follow the look and feel of the OS/2 Warp Server 
integrated installation program, the flow and nature of the questions are 
consistent with the OS/2 LAN Server installation process as Figure 7 on page 14 
illustrates. 
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Figure 6. OS/2 Warp Server Component Configuration 



The inexperienced and experienced network administrator are both catered to by 
providing easy and advanced installation paths. The advanced path is illustrated 
in Figure 7. 
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Figure 7. File and Print Sharing Services Feature Configuration 
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2.5 OS/2 Warp Server Tuning Assistant 

OS/2 Warp Server and OS/2 Warp Server Entry are tuned to support 100 and 32 
concurrently connected users respectively. Once you have installed and 
configured OS/2 Warp Server File and Print Sharing Services you should fine 
tune OS/2 Warp Server to satisfy your specific installation requirements. 

The Tuning Assistant provides automatic tuning and configuration of your OS/2 
Warp Server workstation. 

OS/2 Warp Server does not dynamically retune itself as you add more 
requesters. If you have a growing OS/2 Warp Server environment then you need 
to run this utility at regular intervals to verify that your OS/2 Warp Server 
configuration can support the number of users connecting to resources and 
provide optimum performance. 

Attention 

Please note that the majority of problems you may encounter with OS/2 LAN 
Server and OS/2 Warp Server are likely to be capacity related. 



When you start the Tuning Assistant by selecting the appropriate object from the 
LAN Services Folder, as shown in Figure 2 on page 7, and click on OK, you are 
presented with the screen as shown in Figure 8. 




Figure 8. Server Hardware and Software Configuration Summary 



Note: The OS/2 Warp Server Tuning Assistant is designed to tune server 
workstations and will try to detect your server software configuration. Therefore, 
if you attempt to execute WSTUNE.EXE at a requester you will receive the error 
as shown in Figure 9 on page 16. It is, however, possible to run WSTUNE.EXE 
on a requester by providing a sample configuration to be processed. You can 
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find details on how to do this in “Running the Tuning Assistant on a Requester’ 
on page 18. 



Server Only 

0 An OS/2 LAN Server was nol found on 
this system. 

The tuning assistant must be run on a 
system with LAN Server installed. 



OK 



j Help 



Figure 9. Running the Tuning Assistant on a Requester 

The Tuning Assistant automatically detects key network, software and hardware 
configuration information and, based on the information that you provide, will 
generate warnings if you exceed the server workstation's capacity to support 
your configuration. 

As you can see in Figure 10, the Tuning Assistant recommended that additional 
server RAM and network adapters be added. 




Kelp 



Figure 10. Configuration Warnings/Recommendations Screen 



In it's present form, the Tuning Assistant was first introduced in OS/2 LAN Server 
4.0. The OS/2 Warp Server Tuning Assistant is a natural development of this 
utility and includes variables for other key components that may affect OS/2 
Warp Server performance or capacity. 

Figure 11 on page 17 shows an example of how the LAN Server Tuning 
Assistant has been enhanced to include the requirements of Remote Access 
Services and other key OS/2 Warp Server components in the tuning calculation. 
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Figure 11. OS/2 Warp Server Component Requirements (Server) 



Once you have completed all the panels by typing in your specific environment 
variables you then select Calculate. If any warnings are generated at this point 
you will be informed via the pop up window as shown in Figure 12. 



Warnings or Recommendations Made 

A Warnings or recommendations have 
been generated. 

To view them, go to the ’Warnings’ 
page. 

iOK | 



Figure 12. Warnings or Recommendations Made 

The Updated Files list now includes the Remote Access Services WCLLOCAL.INI 
configuration file {when Remote Access Services is configured) as shown in 
Figure 13 on page 18. 
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Figure 13. Updated Files Screen 



If you are happy with the suggested modifications to each file (which are 
highlighted) then you may put them into effect the next time the system is started 
by simply selecting Apply. 

Note: Backup copies of the existing configuration files will be stored in 
\IBMLAN\BACKUP. 



Backup Files 

jjjfc Tho following llles have changes 
ponding: 

C MSMJ.AriVIBMLAH.UII 
C:\I8MCOMVPROTOCOI. .1(11 
C:V8JM38hF 3VHPFS3H6JNI 

Rnloro thcsR files are changed the 
current flies listed above will be 
backed up to tho BKLAHV BACKUP 
directory 

Do you want to change those files? 
{ Ves j No” j Help | 



Figure 14. Backup Files Confirmation Window 



Running the Tuning Assistant on a Requester 

As mentioned earlier in this chapter, the Tuning Assistant is designed to tune 
server workstations and therefore is not installed on requesters. If you attempt 
to run WSTUNE.EXE on a requester then you will receive an error. 

If you wish to build configuration files for servers on your requester then you 
may do so by first copying WSTUNE.EXE from a server workstation and running it 
in an OS/2 windowed or full screen session, supplying a number of parameters 
from the following list: 

• C/D:] enables you to specify the name of the domain that the server 
workstation will belong to. 
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• [/S:] enables you to specify the name of the server workstation that you 
wish to generate the configuration files for. 

• [/T:] enables you to specify the role of the server. You may select DC or AS 
for domain controller or additional server respectively. 

• C/P:] allows you to specify the package type (ENTRY or ADVANCED). 

• [/ M 0 specifies how much memory is installed in the server (MB). 

• [/A:] specifies the number of network adapters you want the configuration 
file to support (to a maximum of 4). 

• C/U] specifies that you want to use copies of configuration files (CONFIG.SYS, 
IBMLAN.INI, PROTOCOUNI, HPFS386.INI, WCLLOCAL.INI, WSCONFIG.CFG) 
stored in the current subdirectory to generate the tuned configuration files. 

Notes: 

1. When specifying package type via the /P parameter, select ENTRY for an OS/2 
Warp Server Entry server and ADVANCED for an OS/2 Warp Server Advanced 
server. 

2. If you apply calculated changes to files in the current subdirectory no 
backups are created. 

3. /T is always required along with /U if no server is installed. 

For example, if you wish to build and verify a specific configuration for an OS/2 

Warp Server workstation you would enter: 



WSTUNE /D:W4602D01 /S:W4602S01 /T:DC /P:ADVANCED /M:64 /N:4 /U 
Figure 15. Running WSTUNE.EXE on a Requester 

Note: These parameters may also be used with the OS/2 LAN Server 4.0 Tuning 
Assistant (LSTUNE.EXE). 



2.6 Sharing Resources with the Administration GUI 

In this section we will look at how you define shared resources from the 
Administration Graphical User Interface (GUI). This interface, as shown in 
Figure 16 on page 20, may be accessed from the LAN Services folder or from 
the Network folder on the OS/2 Warp Server Desktop and enables you to do the 
following: 

• Manage OS/2 Warp Server users and groups, including the definition of how 
shared resources appear to them and which network applications appear in 
the Network Applications folder on their Desktop when they logon. These 
definitions are referred to as logon assignments. 

• Define resources that you want to share, known as aliases. 

• Specify what permissions users have to access each shared resource. 

• Define and provide access to applications that are stored on server 
workstations but may be executed from requesters. 

• Manage server workstations on the network. 

• Connect to resources that you want to use and manage your own network 
applications. 
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Figure 16. OS/2 Warp Server Administration Graphical User Interface 

OS/2 Warp Server shared resources are defined in the Resource Definitions 
folder (the active window in Figure 16). 

There are three templates which you use to create shared directories, printers 
and serial device. You define the server workstation resources by simply 
selecting the template that matches the type of shared resource that you want to 
share with mouse button 2 and drag and drop the template to an area within the 
folder. In the next two sections we will look at how you share files and printers 
from the OS/2 Warp Server Administration GUI. 

Sharing Files with the Administration GUI 

OS/2 Warp Server provides access to shared files by enabling you to create 
shared directories in which the files are stored. To share a directory you must 
be logged on as an administrator or a user with a privilege level to manage 
shared resources. 

To share a directory with users: 

1. Start the Administration GUI. 

2. Select the domain that you wish to manage. 

3. Open the Resource Definitions Folder. 

4. Select the Directory Template icon, and, while holding down mouse button 2, 
drag the icon to an open area in the Resource Definitions folder and release 
the button. The Directory Alias - Create notebook is displayed, as shown in 
Figure 17 on page 21. 
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Figure 17. Directory Alias • Create notebook 



Note: A directory does not need to exist before it can be shared. OS/2 Warp 
Server will automatically create the directory as part of the resource 
definition process. 

5. Complete the notebook Fields then select Create. The Access Control Profile 
Does Not Exist window, shown in Figure 18, notifies you that you need to 
define user's access to this resource. 
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resource dte&s net esiist* select OK 
to create- 
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Figure 18. Access Control Profile Does Not Exist Window 

Note: To create a shared directory definition without defining an access 
control profile, select Cancel. 

6. Select OK to display the Access Control Profile notebook, select the 
Permissions page then Add. 

7. You then select the users or groups that you want to have access to this 
alias and select the permissions that you want them to have, as shown in 
Figure 19 on page 22, and click on OK. 
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and select the OK push button. 
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Figure 19. Defining an Access Control Profile for a Shared Directory 

8. Select Create and click on OK to propagate the access control profile so that 
the access permissions that we have defined take effect for files contained in 
subdirectories of the shared directory. 
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Figure 20. Propagate Access Control Profile to Subdirectories Window 



Once you complete the above procedure the directory is shared and available to 
be accessed. There is nothing else that you need to do other than providing 
users or groups with logon assignments so they may connect to and use the 
shared directory. 

Note: If you selected Cancel at the point where you were asked whether you 
you wanted to create an access control profile for the resource (Figure 18 on 
page 21) you could subsequently manage access to the resource and propagate 
the access control profile by simply selecting the resource object with mouse 
button 2 and then clicking on the appropriate context menu item as shown in 
Figure 23 on page 25. This is a good illustration of how OS/2 Warp Server 
integrates seamlessly with the Work Place Shell. 
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Sharing Printers with the Administration GUI 

As is the case with creating shared directories, to define a shared printer 
resource you must be logged on as an administrator. In the following example 
you will notice that with OS/2 Warp Server you don't share a physical printer 
port you share an OS/2 print queue. 

To share a printer with users: 

1. Start the Administration GUI. 

2. Select the domain that you wish to manage. 

3. Open the Resource Definitions Folder. 

4. Select the Printer Template icon, and, while holding down mouse button 2, 
drag the icon to an open area in the Resource Definitions folder and release 
the button. The Printer Alias - Create notebook is displayed, as shown in 
Figure 21. 




Description 
riServer name 









lias 



*¥m ' 1 ® mm 111 mm «** ** 

x [iBM4639 •; 

HBM4039 Pius (PostScript) | 

*[W4B02SO1 ]jj} 



■"^Spooler queue name *{lBM4039p| ii|| 



When shared 

Jf&gAt server startup 
if ilBy administrator action 

: || 

!«§• Maximum concurrent connections 

Nj Unlimited 

J^Number of connections «l 

:g. 




•Wfhe spooler queue to be shared 

:||I 




Figure 21. Printer Alias - Create notebook 

5. Complete the notebook fields then select Create. The same Access Control 
Profile Does Not Exist window, as shown in Figure 18 on page 21, notifies 
you that you need to define user's access to this resource. 

Note: To create a shared printer definition without defining an access 
control profile, select Cancel. 

6. Select OK to display the Access Control Profile notebook, select the 
Permissions page then Add. 

7. Select the users or groups you want to have access to this alias and select 
the permissions that you want them to have, as shown in Figure 22 on 
page 24, and click on OK. 
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Figure 22. Defining an Access Control Profile for a Shared Printer 
8. Select Create. 

Once you complete the above procedure the printer queue is shared and 
available to be accessed. There is nothing else that you need to do other than 
providing users or groups with logon assignments so they may connect to and 
use the shared printer. 

Note: By using the drag and drop capabilities of the Administration GUI you 
may provide groups of users with logon assignments by simply dragging a 
shared resource and dropping it on a group of users, and vice versa. 

Support for Thousands of Aliases 

With OS/2 Warp Server you may define thousands of shared resources, known 
as aliases, via the Administration GUI. This is a notable enhancement to the 
LAN Server 4.0 Administration GUI which was restricted in the total number of 
shared resource definitions that could be displayed due to a 64KB data 
limitation. 

To give you an idea of what performance you can expect when administering 
thousands of aliases we performed some tests. To open the Resource 
Definitions folder on a server workstation with a 90MHz Pentium processor took 
45 seconds with 2000 aliases defined, and 2 Vi minutes for 4100 aliases to be 
displayed. 
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2.7 Other Methods of Sharing Resources 

The OS/2 Warp Server Administration GUI is just one way of sharing resources 
in an OS/2 Warp Server environment. In this section we will look at the other 
options provided for sharing resources and managing access to them. 

You can also share resources and manage access to them from: 

• OS/2 Warp Server Desktop 

• OS/2 Command Line 

• Current shares window 

These additional options may be used as an alternative to the Administration 
GUI, although administration by the manipulation of desktop objects is 
dependent upon the Administration GUI being loaded. 

Sharing Resources from the Desktop 

As mentioned at the beginning of this chapter, the Administration GUI is 
integrated with the OS/2 Warp Workplace Shell. This means that you have 
access to additional menu options to start sharing, stop sharing, manage access 
to, and (for directory objects) manage limits. 

The following examples in Figure 23 and Figure 24 on page 26 show the results 
of selecting an object on the desktop with mouse button 2. 




Figure 23. Network Extensions to Desktop Drive Object 
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Figure 24. Network Extensions to Desktop Printer Object 

Selecting any of the menu network options will present you with the appropriate 
notebook from the Administration GUI. 

Example: Sharing a CD-ROM Drive 

To share a CD-ROM drive by alias perform the following steps: 

1. From the Administration GUI, create an directory alias. Complete the fields 
on the Identity page as follows: 

• Alias Name: CDROMDRV 

• Description: Server's CD-ROM Drive 

• Server: W4602S01 

• Path: D:\. 

• When Shared: At Server Startup 

• Maximum concurrent connections: Unlimited 

2. Select Create. 

3. Select Cancel at the Access Control Profile Does Not Exist window. 

The directory alias will be created for you now. 

4. In the Drives folder which resides in the OS/2 System folder, display the 
CD-ROM drive's object pop-up menu by using mouse button 2 as shown in 
Figure 23 on page 25. 

5. Select Manage access ... which will display the Identity page of the Access 
Control Profile notebook. 

6. Select OK at the Access Control Profile Does Not Exist window. 

7. Select the Permissions tab. 

8. Select Add ... 

The Add Access Control Entries window is displayed. 
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9. Select the user IDs or group IDs you want to allow access to the CD-ROM 
drive. Select the permissions you want to grant to the users and groups you 
selected. 



Note: If you generally want to allow access to the CD-ROM drive you might 
select the group called Users and grant Read and Execute (RX) permissions. 

10. Select OK. 

11. Select Create. 

The access control profile for the CD-ROM drive is created. 

Sharing Resources from the Command Line 

Every task that you can perform from the GUI may also be performed from the 
OS/2 command line. This is very useful as it enables repetitive tasks, such as 
the creation of many users and their logon assignments, to be automated via 
OS/2 command files or REXX scripts. 

For example, the following series of commands would produce the same results 
as the scenario we looked at in "Sharing Files with the Administration GUI” on 
page 20. 



NET ALIAS TRANSFER \\W4602S01 O:\DATA\TRANSFER /DO:W4662D01 /W:STARTUP /R: "Shared Directory" /UN 
NET ACCESS TRANSFER /GRANT USERS: RWCDX 
NET ACCESS TRANSFER /APPLY 



Figure 25. Commands to Share a Directory Resource from the Command Line 

Note: These commands will only be accepted if you are logged on as an 
administrator, or a user with special privileges to manage server resources. 

It is possible to remotely manage the server from your DOS or Windows 95 
workstation by using the NET ADMIN command. To perform remote administration 
you would prefix the command with NET ADMIN \\servername /C. 

You will find the complete list of NET commands and associated parameters by 
typing NET (or NET HELP NET command for specific command syntax) at the 
command line or in the OS/2 Warp Server Commands and Utilities online 
publication. 

Sharing Resources from the Current Shares Window 

An administrator may query the resources that are currently being shared via 
the relevant Current shares window. In addition, as is shown in Figure 26 on 
page 28, you also have options to share another, change share, stop share, 
manage access and (for directory resources) manage limits. 
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2.8 Preparing the Server for Client Installation 

Once you have defined the resources that you want to share you need to 
prepare the server so that you can install clients from disk images stored on the 
OS/2 Warp Server CD-ROM or server's fixed disk. 

Which client installation method is best for you? 

If you are installing less than five clients at a time then installing from the 
server's CD-ROM provides a quick and easy installation method. 

If you are installing more than five clients then installing from source files on 
the server's hard disk means that the server's CD-ROM drive is not 
unavailable for use for extended periods of time. 



If the clients have a CD-ROM attached and/or OS/2 installed, you do not need to 
set up the server. 

Make sure that you have two blank 3.5-inch diskettes ready. The OS/2 Warp 
Server client installation process will use these to create remote installation 
diskettes. 

To set up the server to install OS/2 Warp Server clients across the LAN: 

1. Open an OS/2 command prompt and type: 
d: 

cd warpsrv\os2clnt 
wssetup 

Where d: is the hard disk where OS/2 Warp Server is installed. 
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Figure 27. Where will Clients Access Installation? Window 

2. In the Where will Clients Access Installation window, shown in Figure 27, 
specify whether the clients will install directly from the server workstation's 
CD-ROM drive or from files created on the server workstation's hard drive. 

Have the two diskettes, created as part of the server preparation for client 
installation, labelled Remote Installation Diskette and Remote Installation 
Diskette - OS/2 Diskette 1, available. 




Figure 28. File and Print Client Selection 

3. After you have specified where the OS/2 Warp Server source code is located 
you then specify whether to install an OS/2 or Windows client, as shown in 
Figure 28. 
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Figure 29. Remote Installation Diskette Creation 

4. If you have previously created the remote installation diskettes and simply 
wish to install another client then you can skip the diskette creation step. If 
you need to create a new a new Remote Installation Diskette (OS/2 Diskette 
1) for a client with a different network adapter then you can select Yes to 
create new diskettes and select Skip when prompted to create the first 
Remote Installation Diskette. 
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Select the network adapter Installed at the remote workstation. 



If you have a network adapter that is supported by this product but is not in this list, 
select Other adapter to copy the files from the network adapter's driver diskette. 
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Figure 30. File and Print Client Network Adapter Selection 

5. In the window shown in Figure 30 you select the network adapter that is 
present in the remote client, make adjustments to any settings that are 
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required, and continue with the server workstation setup process described 
in Figure 31 on page 31. 
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1. Insert Remote Installation Diskette Into drive A: of 
the remote workstation. 



2. Shut down and restart the remote workstation. 



3. Continue the client installation at the remote 
workstation. 



Help 



Figure 31. Remote Installation Process 

6. Once you have completed the previous steps you select OK and the window 
shown in Figure 32 will be displayed which will report on the number of OS/2 
and Windows workstations attached and show whether the server is 
available to distribute code. 
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The remote Installation begins once you restart the remote 
workstation using the Remote installation Diskettes. Progress 
for the remote installation is displayed below. 



Verify the remote workstation installation is complete, then 
select Close. 
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Figure 32. Remote Installation Status Window 



Now the server workstation is set up to allow you to remotely install the clients. 
Remote client installation is discussed in "Installation” on page 51. 
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Security Consideration 



When a server workstation is running as a remote installation server it sets 
up SRVIFS thus giving free access to the entire drive where the images are 
stored. If you have confidential or private information also installed on the 
same drive as the images, then you will have a security risk with that 
confidential information. 



2.9 Removing File and Print Sharing Services 

If you need to remove File and Print Sharing Services from a server workstation 
you may do so by selecting OS/2 LAN Services installation/configuration from 
the IBM LAN Services folder, taking the Tailored installation path and selecting 
Remove LAN Server from this workstation, as shown in Figure 33. 
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Figure 33. Removing File and Print Sharing Services 



2.10 OS/2 Warp Server Gateway Services 

In this section we discuss the use of OS/2 Warp Server as a File and Print 
Gateway to other file and print subsystems. This feature is not unique to OS/2 
Warp Server and can be implemented using the IBM Peer for OS/2 Version 1.0 
component of OS/2 Warp Connect or previous versions of OS/2 LAN Server. 
Additional software may be required depending on the type of gateway you wish 
to implement. 

It is assumed in this chapter that you have some understanding of the different 
file and print subsystems. 
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Overview and Concepts 

With OS/2 LAN Server the ring 3 server can share any logical drive available to 
OS/2 with the exception of those redirected through OS/2 LAN Server. This 
means that OS/2 LAN Server can be used as a gateway between OS/2 LAN 
Server clients and different file and print sharing environments. The ring 3 
server can also share print queues that are defined for redirected LPT ports. 

This is method of sharing logical devices is also called double redirection. 

Although this implementation has some limitations it is at times financially, or for 
some other reason, a viable solution. In this section we will describe the use of 
OS/2 Warp Server as a File and Print gateway through to other systems. The 
following gateway types are possible: 

• NetWare mapped drives 

• NetWare connected print ports 

• LPRMON connected print ports 

• LAN Server Peer connected print ports 

The following gateway services are possible with the aid of additional software: 

• NFS mounted drives 

— NFS kit for OS/2 including latest CSDs and APARs 

• AS/400 PC Support connected drives 

— AS/400 Client Access or equivalent 
- Communications Manager/2 

NetWare File and Print Gateway Services 

OS/2 Warp Server is able to act as a File and Print Gateway to NetWare Servers. 
This means that an OS/2 Warp Server can share logical drives or print queues 
that are physically on a NetWare server. Requesters that are connected to the 
the OS/2 Warp Server can use these resources without having the NetWare 
requester installed on their machine. This setup may be required for one of the 
following reasons: 

• This reduces the number of connections used on the NetWare Server. 

• Only OS/2 Warp Server requester code needs to be maintained on each 
workstation. There is no need to install NetWare Client code on each 
machine thereby conserving workstation resources, such as disk and 
memory. 

• When migrating from NetWare to OS/2 Warp Server this may be used as an 
interim step whilst the data is migrated. 

Setting Up the NetWare File and Print Gateway 

Figure 34 on page 34 depicts a simple scenario where OS/2 Warp Server is 
used as a file and print gateway to a NetWare Server. 
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Figure 34. NetWare File and Print Gateway Services Overview 



The steps, as shown in Figure 34, are: 

1. From OS/2 Warp Server, you log on to the NetWare file server and gain 
access to resources by using the Capture and Map facilities. 

2. You then issue a NET SHARE for the resources you gained access to in step 
1. Optionally you could create aliases to define the resources. 

3. Once the resources are shared, the file and print clients may access the 
resources by issuing NET USE commands, or have the resources assigned to 
them as logon assignments of current assignments (see “Connecting to 
Network Resources from the OS/2 File and Print Client” on page 62 for a 
discussion on the types of resource assignments). 

In order to connect to the NetWare Server OS/2 Warp Server uses the NetWare 
Client for OS/2 Version 2.11. The version of the NetWare Client for OS/2 
included in OS/2 Warp Server includes the fixes from the OS2C1. Some of the 
features of this Client are: 

• Support for both NetWare 3.x and NetWare 4.x Servers 

• Provides access for up to nine parallel ports 

• Support for OS/2, DOS and WIN-OS/2 sessions 
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The DOS and WIN-OS/2 sessions can be set up for global or private support. 
Global support means that after logging in from a DOS VDM, other DOS 
VDM's are aware of the login. Private support means each VDM is unaware 
of any other login. 

• Support for VMBoot private and Global sessions 

VMBoot is used for support of the NWAdmin utility (for administering a 
NetWare 4.x network). 

In order to set up the File and Print services gateway you need to complete the 
following tasks: 

• Install the NetWare Client for OS/2 

• Configure the NetWare Client for OS/2 

• Login and connect to resources on the NetWare server 

• Configure the shares for use by OS/2 Warp Server requesters 

• Automate the procedures 

Installing the NetWare Client for OS/2: The NetWare client is part of the 
integrated installation if the File and Print services gateway option is selected as 
part of the OS/2 Warp Server installation process. Figure 35 shows the 
parameters that you are prompted for. 
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Adapters for File and Print Sharing Network 



These are the network adapters you will use for File and 
Print Sharing Services. To change the adapters, select 
Adapters and Protocol Services in the list on the left side of 
this window. 



Network Adapters 

I 0 IBM Token-Ring Network Adapter 

II 1 LAN Distance Logical Adapter 



Figure 35. Integrated Installation - NetWare File and Print Services 

• You are required to specify the drive on which the NetWare Requester will 
be installed 
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• The default server to make a connection to (optional) 

• The network adapter that will be used to connect to the NetWare Server, 
notice that only the available adapters are selectable 

If you choose to install the NetWare Client for OS/2 from the diskette images you 
will be prompted for more parameters. These are documented in the NetWare 
Client for OS/2 Installation and Configuration red book. 
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Figure 36. NetWare File and Print Services Folder 



If you wish to reconfigure the NetWare Client you can run the installation Utility 
from the NetWare File and Print services folder. From the action bar, select the 
Installation pull-down menu. From the Installation pull-down menu select 
Requester on workstation.... The options that you have are displayed in 
Figure 37 
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Figure 37. NetWare Installation and Configuration Program 

Since the requester is already installed this will provide you with the option to 
change CONFIG.SYS without copying the files over again. 



36 Inside OS/2 Warp Server, Volume 1 






Configuring the NetWare Client for OS/2 

During the installation a default NET.CFG file is created with default settings. 
Usually the defaults should be fine for most installations however you may need 
to configure the NetWare Client if: 

• Your workstation has more than one network adapter or the adapter is not 
using default factory settings 

• Your network uses an Ethernet frame type other than Ethernet 802.2 

Configuration may also be useful in these circumstances: 

• If you want to change the default packet signature security level 

• If you want to turn off Packet Burst or Large Internet Packet transmissions 

• If the workstation will connect to a token-ring network using source routing 

• If the workstation will use NetBIOS or Dual NetBIOS protocols 

• If the workstation will use Named Pipes protocol 

• If you want your workstation to connect to a preferred Directory tree 

• If you are setting up Remote Program Load (RPL) workstations 

• If you want to change your default login drive 

To reconfigure the NetWare client you will need to use the Install icon located in 
the Novell folder on your desktop. See Figure 37 on page 36. Alternatively you 
may edit the NET.CFG file that is in use using a text editor such as E or EPM. 

The NET.CFG file is a text file that contains your tailored configuration options. 
When you start up your workstation the NetWare Client for OS/2 searches for a 
NET.CFG in the directories specified in the DPATH line in the CONFIG.SYS. If the 
Client does not find a NET.CFG it starts up using the default values built into the 
software. 

Connecting to resources on the NetWare Server: You should now have access 
to a NetWare Server. You may log in the server either from the command line 
or from the NetWare Tools program which is in the Novell folder on your 
desktop. The difference between the two is that the command line utility runs a 
login script. Login from the Tools program does not run a login script. 

To login from an OS/2 command prompt enter: 
login username 

To log in using your username to a specific server, type: 
login servername/username 

You will then be prompted for a password. 

The NetWare Tools allows you to do the following: 

• Manage drive mappings 

• Manage printer connections and setup 

• Manage directory tree and server connections 

• Display network users 

• Send messages 



Chapter 2. File and Print Sharing Services 37 





Figure 38. NetWare Tools Network Option 



Note: Choosing the Settings option disconnects all current server connections. 
Make sure that all open files and applications are closed. 

To login to a NetWare Server from the Tools program choose the server option 
off the Tools Menu. After doing this a Server Menu Item appears on the Action 
bar. Choose the Attach option of this menu to attach to a server. You will be 
prompted for the Server, Username and Password. 

Mapping a Drive: Once you have logged on you may now map your local drive 
letters to the NetWare Servers directories. By double clicking on a drive within 
your NetWare Tools folder you will be presented with a MAP selection window 
as shown in Figure 39 on page 39. In the figure the user is not logged on so no 
volumes or directories are shown. An attach button allows you to logon into 
another NetWare Server. 
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Figure 39. NetWare Tools, Mapping a Drive 



Once you have logged on, select a free drive by double clicking on it within the 
drives window. You will be presented with a window that allows you to select 
the volume and the directory within the volume. If the drive that you wish to 
attach to is on a another server, select the attach button to attach to that server. 



The NetWare requester for OS/2 also has a command line option that allows you 
to map drives from the command line. The syntax of the MAP command is: 

MAP[opti on j /VER][dri ve:=][path] 

Where the options are: 

• DEL - to delete a drive mapping 

• N - to map the next available drive 

• P - to map a drive to a physical volume on a server 

• /VER - to display the version information 

For example to map the next available drive to the login directory on server 
ITSO use the command: 

MAP N:=ITS0/SYS: LOGIN 

To delete the above drive mapping you would use the command: 

MAP DEL N: 
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To map drive M: to SYS:PUBLIC use the command: 

MAP M:=SYS: PUBLIC 

Setting up a Print Queue: In order to redirect print queues from your 
workstation to a NetWare server you will need to select the Printers option on 
the Tools Action list. 

A Printer Ports window will be displayed. You can select a port by double 
clicking on it or by selecting the Capture option of the Printers action item 
capture all output from a local printer port to a NetWare Print Queue. You will 
be presented with the options as shown in Figure 40. 
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Figure 40. NetWare Tools, Capturing a Printer Port 



The following options are available: 

Option Function 

Notify Confirms print job completion 

Form Feed Places a page break between print jobs 
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Copies 
Tab Size 
File Contents 
Print Banner 

Form 



Specifies the number of copies to print 

Specifies the number of characters in a tab stop 

Specifies the type of print file being printed 

Allows for a banner page to be printed at the front of your print 
job 

Allows you to select a defined print form 



Once all settings for drives and print queues being shared are defined, they 
need to be saved. To do so select the Network pull-down menu from the 
NetWare Tools action bar and select Save Settings {See Figure 38 on page 38). 
You will be prompted for a file name. The default extension for this file is NWS. 



Configuring the shares for use by OS/2 Warp Server requesters: To configure 
the logical drive and print queue you need to logon to LAN Server as an 
administrator. Once you are logged on there are a number of methods that you 
can use to share the resources. 



You can share the resources using the NET SHARE command or you can create an 
alias to define the resource. However, it might be best to use the NET SHARE 
command as the NetWare server may not always be available. 

For example, to share the N drive to an unlimited number of users with read and 
execute access, you would issue the command: 

NET SHARE NETWARE=N: /UNLIMITED /PERMISSIONS: RX /REMARK: NWare Drive 

Access Control: Since the drive being shared is a logical drive there are two 
access control mechanisms in place. These access control mechanisms work 
independently from each other. Checking is done at each access control point. 
The first access control mechanism is present at the NetWare server. The user 
ID used to log on to the NetWare server from the OS/2 Warp Server can have 
any of the following rights defined on a resource: 

• S - Supervisory 

• R - Read 

• W- Write 

• C - Create 

• E - Erase 

• M - Modify 

• F - File Scan 

• A - Access Control 



The NetWare access control mechanism will ensure that these rights are 
preserved. These rights only apply to the user ID logged on at the OS/2 Warp 
Server gateway machine. 

LAN Server is provides the second access control mechanism. These access 
controls will apply to the user IDs logged on at the OS/2 Warp Server clients. 
LAN Server allows the following access controls to be defined for a shared 
resource: 

• X - Execute 
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• R - Read 

• W - Write 

• C - Create 

• D - Delete 

• A - Attributes 

• P - Permissions 

When an OS/2 Warp Server client attempts to gain access to the double 
redirected resource the success or failure of the attempt will be determined as 
follows: 

1. First, when a user attempts to access the resource, the LAN Server access 
control mechanism will check if the the user has the appropriate rights. 

These rights will have been defined using the NET SHARE, NET ACCESS 
commands or from the Administration GUI. 

2. If the user does not have appropriate access permission the attempt will fail. 
If the user does have appropriate access permission the request will be 
passed on to the NetWare server. 

3. Checking on the NetWare server will be done using the user ID logged on to 
the NetWare server from the OS/2 Warp Server gateway machine and not the 
user ID at the client workstation. 

4. If the user has sufficient access, access is granted and the user can make 
the changes they want. If the user does not have appropriate access 
permission an error message will be displayed. 

Automating the Process : The above procedure has to be followed each time the 
NetWare or LAN Server machine is restarted. In order to make this process less 
cumbersome it is best to automate it. 

You can automate the login process to the NetWare server by doing the 
following: 

• Map all the drives you need 

• Capture any printer ports needed 

• Save the setting to a file, for example, LOG.NWS, the .NWS (for NetWare 
Settings) extension is automatically added 

• Add the following to the STARTUP.CMD 

NWT00LS.EXE LOG.NWS AUTOEXIT 
EXIT 

• Add the following lines to the end of the CONFIG.SYS file: 

Note: The user ID that is used to log in to the NetWare server should not 
have the password enabled. Having the password enabled will stop 
the login process. 

CALL=C: \NETWARE\NWSTART.EXE 
CALL=C: \NETWARE\LOGIN.EXE server/user 

You will also need to automate the LAN Server logon and resource sharing. 

This can be done by: 

1. Logon to the server 

Add the following line to STARTUP.CMD after the NET START SERVER command: 
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logon userid /p: password 

Where userid is a valid administrator user ID and password is the password 
corresponding to this user ID. 

2. Share the resources 

Use the NET SHARE command to share the resource. 

Considerations 

The following limitations exist when using the NetWare File and Print Gateway: 

• Authentication between the gateway server and the remote server is done 
on the basis of the user logged on at the server or the workstation ID of the 
server, depending on the protocol. The identification of the client originating 
the request is not forwarded through the gateway. 

• The machine acting as the NetWare gateway will have to remain logged on 
to a NetWare server while these services are in use. The machine will have 
to be secured by a lockup password or equivalent. 

• Only job submission is supported through the gateway. Printer 
management, job management and queue management will not work and 
are not supported. Alerts generated for the print jobs by the remote server 
will be sent to the gateway server and will not be forwarded on. 

TCP/IP Services Interoperability 

This section will describe how to use TCP/IP Services in conjunction with other 
components of OS/2 Warp Server in order to provide access to TCP/IP networks 
for clients that do not have any TCP/IP capabilities on their own. 

Using OS/2 Warp Server as a TCP/IP File Sharing Gateway 

File and Print Sharing Services of OS/2 Warp Server not only enables you to 
share files and directories that reside on the server itself, but it also allows you 
to share network resources that actually reside on remote systems. This is 
sometimes called the double redirection technique. The following provisions on 
how this can be done should be considered: 

• You cannot double-redirect OS/2 Warp Server or OS/2 LAN Server file 
resources with File and Print Sharing Services; you have to set up cross 
domain aliases. 

• You need to install the appropriate client software on your OS/2 Warp Server 
system in order to connect to the remote file server. 

• Being a client to that remote server, you need sufficient permissions to 
access the shared resources. 

One way of implementing that kind of a file sharing gateway with OS/2 Warp 
Server can be accomplished by having OS/2 Warp Server act as a NFS client. 
OS/2 Warp Server can then share NFS-mounted drives for any LAN Requesters 
that are connected to it but which do not have NFS client capabilities of their 
own. Please see “Network File System (NFS) Services” on page 246 for more 
information on how to integrate the NFS client at the OS/2 Warp Server. 

Figure 41 on page 44 shows a scenario for a TCP/IP file sharing gateway. 



Chapter 2. File and Print Sharing Services 43 




OS/2 Warp Server 

running NFS client 



Mounted NFS drive 
shared as Warp Server 
file resource 



LAN Client 

OS/2 Warp Connect 
OS/2 LAN Requester 
DOS LAN Requester 
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Figure 41. TCP/IP File Sharing Gateway 

Please see Chapter 2, “File and Print Sharing Services" on page 7 for more 
information about how to share file resources. 

Access Permissions , Case Sensitivity , and File Locking: Three issues must be 
addressed when discussing double-redirection of NFS-mounted drives with OS/2 
Warp Server: 

Access Permissions: NFS itself does not provide for access permissions for files 
or directories like OS/2 Warp Server does with File and Print Sharing Services. 
NFS can only restrict access to an exported directory to a list of clients, and it 
can allow for read-only or for write access. Any further detailed access 
protection scheme is up to the underlying operating system or file system. 

When an NFS client attaches to a server, the client name will first be checked 
against the export list. If the names match, the user at the client system has to 
identify himself, and based on this information, access to the exported file or 
directory may be restricted further. Let's consider the following: 

Example: In the case of a UNIX NFS server, a client system (joes-pc) may be 
listed for read access in the export list, and that is all that NFS requires. 

# export list for sample NFS server 

# directory NFS permissions Export list 

/u/joe rw joes-pc franks-pc carries-pc 

If the user (Bill) at that client authenticates himself properly to UNIX (not to 
NFS!), he will be able to mount the requested directory. 

user: bill 

password: ****** 

UNIX user ID: 102 

UNIX group ID: 201 

UNIX group: clerks 
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What that user can actually do to that resource is limited to the permissions 



Ined within the UNIX file 


system, which is totally outside the control of NFS. 


-rwxr-x — 


1 joe 


janitors 


1853 Sep 22 18:17 Mwm 


-rw-rw 


1 joe 


janitors 


47 Sep 22 18:17 Xant 


-rw-rw 


1 joe 


janitors 


16387 Sep 22 18:17 Xmh 


-rw-r 


1 joe 


janitors 


1940 Sep 22 18:24 smit.log 


-rw-r 


1 joe 


janitors 


0 Sep 22 18:23 smit. script 



In this case, user Bill would not be able to do anything on /u/joe because he is 
neither the owner of the resource, nor is his group, or anyone else, allowed 
access. 

For the purpose of this scenario, you should first determine what access 
permissions the clients desire at the remote file server. Then log on from the 
OS/2 Warp Server NFS gateway with a user ID that has sufficient permission at 
the NFS server system to satisfy those requirements. You can, of course, limit 
the access permissions of that user for the clients using File and Print Sharing 
Services access profiles. 

Case Sensitivity: Since many NFS servers actually run on UNIX or UNIX-like 
systems, there may be problems with file names in upper, lower or mixed case. 
The UNIX file system, and probably others as well, will treat any file name 
spelled in different cases as different files, as shown in the following example: 

FileName 
FILENAME 
f i 1 ename 

Since the OS/2 HPFS file system itself is not case-sensitive to file names, the 
names in the above example would result in one and the same file, no matter 
how they are spelled. The name actually used for a file would be the first one 
ever given to it. The OS/2 FAT file system only uses uppercase file names that 
comply with the 8.3 convention (eight character file name, separation period, 
three character extension). 

This leads to the question of how clients that use OS/2 Warp Server as an NFS 
gateway will be able to differentiate between files at the NFS server which have 
the same name, but are spelled in different ways. To overcome this, the OS/2 
NFS client (which would run on the OS/2 Warp Server system) can be configured 
to respect case sensitivity by starting it with the -c and -z options. 

Note: Since OS/2, which provides the underlying file system, is not case 
sensitive, an OS/2 NFS server will not recognize case sensitive file 
names. 

File Locking: An NFS server does not provide file locking capabilities, as 
strange as that is in a file sharing environment. This function is left to the NFS 
clients. The OS/2 NFS client will respect file and record locking if SUN Lock 
Manager is installed and running at the NFS server system. 

Using OS/2 Warp Server as a TCP/IP Remote Printing Gateway 

File and Print Sharing Services of OS/2 Warp Server not only enables you to 
share printers that are attached to the server itself, but it also allows you to 
share printers that actually reside on a remote system. This is another kind of 
double redirection technique. The following provisions on how this can be done 
should be considered: 
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• You need to install the appropriate client software on your OS/2 Warp Server 
system in order to connect to the remote print server. 

• Being a client to that remote server, you need sufficient permissions on the 
shared resources in order to allow clients to access print queues on the 
remote server. 

One way of implementing that kind of a remote printing gateway with OS/2 Warp 
Server can be accomplished by having OS/2 Warp Server act as a TCP/IP line 
printer client. OS/2 Warp Server can connect to TCP/IP printers by using either 
the LPRMON or the LPRPORD function provided in TCP/IP Services. OS/2 Warp 
Server can then share printers for any LAN Requesters that are connected to it 
but which do not have TCP/IP capabilities of their own. Figure 42 shows a 
scenario for a TCP/IP remote printing gateway. 
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Figure 42. TCP/IP Remote Printing Gateway 

Please see Chapter 2, “File and Print Sharing Services” on page 7 for more 
information about how to share printer resources. 



Using OS/2 Warp Server as a Communications Gateway for 
Internet Access 

The File and Print Sharing Services of OS/2 Warp Server allow you to share a 
serial interface (COM port) over the LAN so that users from other workstations 
can access any devices attached to that port at a server. By making use of this 
capability of OS/2 Warp Server, you can support a group of LAN users with 
Internet access without the requirement of having a modem and telephone line 
available to each of them. 

You need to have File and Print Sharing Services installed at the server, and you 
need either an OS/2 Warp Server client, OS/2 Warp Connect or OS/2 LAN 
Requester Version 3.0 and above in order to access a shared COM port for the 
IBM Internet Connection. 

Note: You also need to register each user for Internet access, for example with 
the IBM Internet Connection, because it is the user's client that actually 
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performs the dial-up to the Internet service provider, even if the server's 
COM port is used. The server does not require any specific Internet 
connectivity at all, just a modem and a telephone. 

Please refer to Network Administrator's Reference Volume 3: Network 
Administration Tasks for more information about how to share a serial port over 
the LAN. Figure 43 shows a scenario of shared COM ports for Internet access. 



World Wide Web 




Connection 

OS/2 Warp Connect 
OS/2 LAN Requester 

Figure 43. Internet Access via Shared COM Ports 
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Chapter 3. File and Print Clients 



In OS/2 Warp Server the OS/2 file and print client, also called requester, has 
some minor functional enhancements over the OS/2 LAN Requester shipped with 
OS/2 LAN Server 4.0. DOS LAN Services, however, features a large number of 
enhancements. Therefore, much of this chapter will concentrate on the DOS, 
Windows and Windows 95 clients. 

In Chapter 2, “File and Print Sharing Services” on page 7 we looked at how to 
share resources in an OS/2 Warp Server environment. In this chapter we will 
look at how users connect to these shared resources. 




Figure 44. Client Machines (Requesters) Supported By OS/2 Warp Server 



OS/2 Warp Server supports a broad range of clients by providing requester code 
to match and integrate with the most common workstation operating system 
environments. OS/2 Warp Server is also backward compatible with previous 
OS/2 LAN Server clients which allows you to incrementally add OS/2 Warp 
Server servers to an existing LAN Server network and provide complete 
compatibility between systems. 

The following requesters are provided with OS/2 Warp Server: 

• OS/2 Client (OS/2 LAN Requester) 

• DOS Client (DOS LAN Services) 

• Windows Client (DOS LAN Services Windows Support) 

• Windows 95 Client (DOS LAN Services for Windows 95) 

Note: In addition, OS/2 Warp Server supports (but does not include) Windows 
for WorkGroup and Windows NT clients connecting to OS/2 Warp Server shared 
resources. The Novell NetWare Requester for OS/2 is included to provide a 
gateway to resources located on NetWare servers (see 2.10, “OS/2 Warp Server 



© Copyright IBM Corp. 1996 



49 





Gateway Services" on page 32). Macintosh clients are supported via IBM's LAN 
Server for Macintosh add-on product which is available separately. 



3.1 What is a Requester? 

Before looking at what each requester provides in terms of features and 
functions it is important to understand the purpose of a requester. 

A requester is a workstation from which you can log on to a domain or access a 
server (IBM or non-IBM) and use resources. After successful logon it is possible 
to access shared resources and use the processing capability of the servers. 
Because you can access shared resources from requesters, you can reduce your 
hardware requirements for the requester workstations. 

There are three main types of requesters, or clients, in the IBM OS/2 LAN 
environment: 

OS/2 LAN Requester: An OS/2 workstation with requester functions of the OS/2 
Warp Server product installed and running. 

DOS Requester A workstation with DOS LAN Services installed and running (see 
3.3, “DOS File and Print Client (DOS LAN Services)” on page 64). You can 
install DOS LAN Services on a workstation running DOS with or without 
Windows. A version of DOS LAN Services is also provided with OS/2 Warp 
Server for workstations running Windows 95, we look at this in 3.5, “Windows 95 
Client (DOS LAN Services for Windows 95)” on page 87). 

Peer Workstation : This is a special type of requester. Like a server, a peer 
workstation shares it's resources with users on a LAN (see 3.9, “Sharing 
Requester Resources with the Peer Service” on page 96). A peer workstation 
can also be used as a requester. 



3.2 OS/2 File and Print Client (OS/2 LAN Requester) 

The OS/2 LAN Server 4.0 Requester is the component of OS/2 Warp Server that 
provides LAN connectivity for workstations running OS/2. It is also available as 
a component of both the OS/2 Warp Connect and OS/2 LAN Server 4.0 products. 

The main features and functions of the OS/2 LAN Requester are: 

• Graphical user interface (GUI) 

• Access to network resources 

• Network messaging 

• Network DDE and Clipboard 

• API support 

• Connectivity with other network programs 
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Figure 45. OS/2 Warp Server Client Installation 



OS/2 Warp Server provides you with a number of options to install clients: 

Across the LAN: Select this installation option where your clients do not have a 
CD-ROM attached. If you select this installation path you must: 

1. Prepare your server workstation for client installation, which includes the 
creation of client remote installation diskettes, and is described in 2.8, 
“Preparing the Server for Client Installation” on page 28. 

2. Restart the remote client with the Remote Installation Diskettes that you 
generated as part of the server preparation procedure. 

Remote Installation Prerequisites 

You must already have OS/2 version 2.0, 2.1, 2.11 or OS/2 Warp (with 
WIN-OS2) installed on the client in order to install any of the OS/2 clients. 

3. If the installation program detects that OS/2 Warp is already installed on the 
workstation it prompts you to specify whether you wish to reinstall OS/2 
Warp with networking support, or only install networking support. 

If you have multiple copies of OS/2 Warp installed on your system, for 
instance where you have different bootable partitions for whatever reason, 
you will be asked to select a version of OS/2 Warp to use for networking 
support. 

4. After removing the remote installation diskette the workstation will restart 
and, if selected, will install the OS/2 Warp Server and then the OS/2 Warp 
Server installation program. If you select to reinstall OS/2 Warp and wish to 
retain existing programs, data and system configuration then you must 
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obviously not format the partition and ensure that the appropriate check 
boxes are selected on the Advanced Options screen. 

5. After completing the fields in the Welcome to OS/2 Warp Server Installation 
window, as shown in Figure 3 on page 11, you are then asked whether you 
would like to install each of the client components, which are: 

OS/2 File and Print Client 
Remote Access Client 
TCP/IP Client 

System Management Client 




OS/2 File and Print Client altows your workstation to 
access files and printers on a Local Area Network. 
You can also access files and printers on other • 
workstations running IBM LAN Server, Microsoft HI. 
and Microsoft Windows for WorkGroups This installs 
IBM LAN Requester. 



Do you want to install OS/2 Pile and Print Client? 



jj ffes. in s tall 
3 Ho. do not install 



Cancel 



Figure 46. OS/2 File and Print Client Installation 

The OS/2 File and Print Client is equivalent to the OS/2 LAN Requester provided 
with OS/2 LAN Server 4.0. We will look at the integral Administration Graphical 
User Interface in “Graphical User Interface” on page 60. 





Each workstation on a network must have a name that 
Is <Sf fersnt f r om others onthenetwork. . .. 
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type a different name. * 
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Figure 47. OS/2 File and Print Client Installation - Workstation Name 
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You must specify a name for the workstation which must be unique on the LAN 
and may be up to 15 characters in length. This is the equivalent of 
COMPUTERNAME in OS/2 LAN Server. 



RHd and Pr In ? UenfcT>MVaifi Whine 







Users : who work together should use the same domain 
name. Per example, members of a department should 
specify the same domain name for easier access to 
shared resources. 



Type the domain name you will use with this 
Workstation. 



mm 



Cancel 
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Figure 48. OS/2 File and Print Client Installation - Domain Name 

You must specify the domain that the workstation belongs to. This completes 
the information that you need to provide in order to configure the OS/2 file and 
print client. 
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With Remote Access Client you can dial Into the server 
over telephone tines and access files, applications, and 
printers on the LAN. Your workstation will behave just 
like it was attached to the LAN. ^ his installs IBM LAN 
Distance Remote. 



Do you want to Install Remote Access Client? 



:bk 



— I r 

1 Cancel 






Figure 49. Remote Access Client Installation 



The remote access client is the equivalent of the LAN Distance Remote client. 
Installation is optional. 
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Figure 50. Remote Access Client Settings 

To configure the remote access client you simply need to specify the 
communications port that you will be using for remote LAN connections, the type 
of modem that will be attached to this communications port and the telephone 
number that needs to be dialed to establish a connection with the connection 
server. For more detailed information please refer to Chapter 7, “Remote 
Access Services” on page 281. 



■TCP/IP CHonr 




With TCP/IP services, you can access the Internet over 
telephone Lines using a modem or an internet-enabled 
LAN. TCP/IP Services contains applications that can help 
you access internet resources, T his installs the IBM 
TCP/iP for OS/2 applications. 
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Figure 51. TCP/IP Client installation 

You may then specify whether you wish to install the TCP/IP client. Refer to 
Chapter 5, “TCP/IP Services” on page 167 for information on precisely what 
functions are provided. 
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Figure 52. TCP/iP Client Installation - DHCP/DDNS Support 

You will find a definition and an explanation of both the Dynamic Host 
Configuration Protocol (DHCP) and Dynamic Domain Name Server (DDNS) in 
Chapter 5, “TCP/IP Services" on page 167. 




Figure 53. System Management Client Installation 

Finally you have the option of installing the System Management client. Systems 
Management Services is not discussed in this publication. A separate redbook 
Inside OS/2 Warp Server, Volume 2: Using SystemView, Backup/ Recovery and 
Advanced Print is planned to be available in May 1996. 
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Figure 54. System Management Client Configuration 

If you select to install the System Management Client you will need to provide 
details of the software distribution server's address, and so on. This information 
will be found on the server In the General page of the SystemView Configuration 
panel, as shown in Figure 55. 
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Figure 55. SystemView Software Distribution Configuration 



If, in retrospect, you decide that you do want the System Management Client 
installed, you may remove it be performing the following steps: 

1. Open the System Management - SystemView icon on the Desktop. 
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2. Open the Install Utility icon. 

3. From the Actions menu, select Delete. 

From CD-ROM: If you have a CD-ROM attached to the client workstation, and a 
version of OS/2 that is supported by OS/2 Warp Server, you may install the OS/2 
client components by inserting the OS/2 Warp Server CD-ROM and typing the 
following with the CD-ROM as the current drive d: 

d:\0S2\CLIENT\INSTALL 

The remainder of the procedure is very similar to the remote installation method. 

Cancelling Local Client Installation 

To cancel the installation before it begins, just select Cancel on the following 
Workplace Shell message: 

Are you sure you want to close all windows and active programs... 

Then type the following command at an OS/2 command prompt: 
c:\0S2CLNT\CLIENTS\CASCLEAN d: 

where c: is the drive you selected for the installation subdirectory and d: is 
the OS/2 system boot drive. 



OS/2 Client Installation Considerations 

Serviceability and Diagnostic Aids 

OS/2 Warp Server Remote Client requires the Serviceability and Diagnostic Aids 
of OS/2 Warp be installed. Do not deselect this OS/2 Warp install option. The 
following messages might be displayed at reboot if you deselect this option: 

(SYS1718) The System cannot find the file C:\0S2\L0G.SYS 

(SYS1718) The System cannot find the file C:\OS2\MDOS\LPTDD.SYS 

(SYS1718) The System cannot find the file C:\0S2\SYSTEM\L0GDAEM.EXE 

Incomplete Client Installation Caused by PCMCIA Drivers 

Before installing OS/2 Warp Server client software over an existing version of 
OS/2 Warp on a PCMCIA workstation, edit the workstation's CONFIG.SYS file and 
remove or comment out lines that contain any of the following driver names: 

• PCM2ATA.SYS 

• ICMEMMTD.SYS 

• ICMEMCDD.SYS 

To comment out a line in the CONFIG.SYS file, add the keyword REM to the 
beginning of the line. Save the changed CONFIG.SYS file; then shut down and 
restart the workstation. 

If any of these drivers are present, the file and print sharing client installation 
program can fail. 
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Client LAN Adapters 

For more information on installing specific adapter cards, see the READMAC.TXT 
file located in the \CID\NIFS directory on CD-ROM 1. If you encounter a problem, 
you may need to contact the manufacturer of your adapter card for technical 
support. 

Installing Clients With No LAN Adapter 

Select NO ADAPTER from the adapter driver list. This selection will install the 
IBM Parallel Port adapter on your workstation, and will allow you to install any 
combination of OS/2 Warp Server Remote Client products. At startup time you 
will see the following message: 

The IBM Parallel Port ANDIS MAC Driver is installed. 



Without a LAN Adapter you are limited in the connectivity functions that you can 
perform; however, you can use the TCP/IP async connection (SLIP or PPP) to 
connect to other TCP/IP systems or you can use LAN Distance Remote to 
connect over an async modem to a LAN Distance Connection Server and use 
IBM Peer for OS/2 or IBM LAN Requester to access a LAN. 

If you subsequently need to add an adapter, you may do so by performing the 
following steps: 

1. Shut down and turn off your workstation. 

2. Install the new LAN Adapter. 

3. Turn on your workstation. 

Note: if you have installed LAN Distance Remote, you must remove it before 
continuing. You can use the LDREMOVE command, located in the \WAL 
directory, to remove LAN Distance Remote. 

4. In the OS/2 System folder, open System Setup; then open the Adapters and 
Protocol Services MPTS object. 

Note: You alternatively might issue the following command from an OS/2 
command line: \IBMCOM\MPTS. 

5. Select Configure. 

6. In the Configure window, select LAN Adapters and Protocols; then select 

Configure. 

7. In the Current Configuration area of the LAPS Configuration window, select 

IBM OS/2 NETBIOS under IBM Parallel Port in the list. 

8. Select Remove; then select Yes in the confirmation window. 

9. The IBM Parallel Port is now highlighted. Select Remove; then select Yes in 
the confirmation window. 

10. In the Network Adapters area, select the adapter type you installed; then 
select Add. 

11. In the Protocols area, select IBM OS/2 NETBIOS; then select Add. 

12. Select OK. 

13. Select Close in the Configure window; then select Exit to close MPTS. 

14. Shut down and restart your workstation. 
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Installing OS/2 Client on ThinkPad 

If you are installing OS/2 on an IBM PS/2 Model 76 or an IBM ThinkPad 700, 

700C, 720, or 720C, you need to replace the ABIOS files on the OS/2 Installation 
diskette with files from the Reference diskette. Do the following: 

1. If you are using a ThinkPad, detach it from the docking station. Create a 
Reference diskette by following the documentation that came with your 
computer. 

2. Make a copy of the Installation diskette. Type the following command and 
press Enter: 

DISKCOPY A: A: 

Remove and insert diskettes when prompted to do so. 

3. Remove the copy from drive A: and insert the original Installation diskette. 

4. Turn your computer on. If your computer is already on, press Ctrl + Alt + Del 
to restart it. 

5. When you are prompted to do so, remove the Installation diskette, insert 
diskette 1, and press Enter. 

6. When the Welcome screen is displayed, press F3 to display the command 
prompt. 

7. Insert the copy of the Installation diskette into drive A:. 

8. Type A:\DEL *.BI0 and press Enter. 

9. Remove the copy of the Installation diskette and insert the Reference 
diskette you created into drive A:. 

10. If your computer has more than one diskette drive, insert the copy of the 
Installation Diskette into drive B:. In the next two steps, you will be 
prompted to insert diskettes into both drive A: and drive B.\ If your computer 
has only one diskette drive, when you are asked to insert a diskette into 
drive A:, insert the Reference diskette into the diskette drive. When you are 
asked to insert a diskette into drive B:, insert the copy of the Installation 
diskette into your diskette drive. 

11. Type COPY A: \*.BI0 B:\ and press Enter. 

12. Type COPY A:\ABIOS.SYS B:\ and press Enter. 

13. Turn off your computer. 

14. If you are using a ThinkPad, return it to the docking station. 

The OS/2 Warp Server Remote Client does not automatically detect the ThinkPad 
755CD adapter type. You must select the PCMCIA option during installation. 

The IBM ThinkPad 755CD's default audio configuration of Memory 10 = X'220' 
can conflict with many PCMCIA (credit card) LAN cards. The PCMCIA cards' 
Memory 10 = X'A20' so the conflict with the X'220' sound feature is not obvious. 
However, the sound feature is an emulation of the Sound Blaster 16 card which 
only has 10 bit addressing, and the last 10 bits of both the PCMCIA and Sound 
Blaster 16 cards are the same '10 0010 0000' in binary. 

To install a PCMCIA Token Ring or a PCMCIA Ethernet card into an IBM 
ThinkPad 755CD you must change the audio Memory 10 address to X'240' (or 
some other unused address). 
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If you have conflicting IRQs or Memory 10 addresses you will see an error 
flashed on the screen for 10 seconds during restart that says the IBM2SS01.SYS 
file did not load. 

Then you receive a restart message that your LAN device driver did not load. 

PCMCIA Token-Ring cards and the Future Domain SCSI adapter can interact to 
cause I/O errors on a CD-ROM attached to the SCSI adapter. To avoid these I/O 
errors, change the SCSI Controller Memory Address on the Docking Station I 
from CAOO to an unused memory address (CEOO or DEOO). Refer to the IBM 
ThinkPad Dock I Users Guide {part number 71G4054) page 5-5 for instructions on 
how to change the SCSI Controller Memory Address. 

The 701 ThinkPad Chips and Technology Video comes set to MMIO = CCOO. This 
conflicts with the MMIO default on several PCMCIA cards. Reset the MMIO on 
the 701 video to D400 to avoid conflicts with PCMCIA cards. The 701 audio can 
also conflict with the IRQ and lOAddress of the PCMCIA cards. To get started 
you can disable the audio function, install OS/2 Warp Server Remote Client, then 
enable the audio at addresses and IRQs that are not used by the PCMCIA cards. 

ThinkPads on Dock II docking stations with Adaptec SCSI adapters can hang 
during OS/2 Warp Server Remote Client install. To prevent this hang, change 
the SCSI port address from 340h to 140h using the switch block switch number 4. 
Page 78-79 of the IBM ThinkPad Dock II User's Guide {part number 84G9682) 
describes where the switch block is located and how to change the port address 
of the SCSI adapter. 

Graphical User Interface 

As discussed in 2.6, “Sharing Resources with the Administration GUI" on 
page 19, you can access the OS/2 Warp Server Administration GUI, as shown in 
Figure 56 on page 61, from the IBM LAN Services folder or from the Network 
folder. 
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Figure 56. OS/2 Warp Server Administration Graphical User Interface 



If you are logged on as a user without administrator privileges then you will only 
be able to modify changes to your user account definition, such as your 
password and logon assignments, as shown in Figure 57 on page 62. 
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Figure 57. Modifying your User Account Settings 



Connecting to Network Resources from the OS/2 File and Print Client 

After the administrator of the domain has defined a resource as an alias and 
granted you permission to access it, a local device name needs to be assigned 
to the alias before you can use it. 

A local device name is a drive, LPT port, or COM port defined on your 
workstation. The type of resource you are using {directory, printer, or serial 
device) determines the local device name you should use. 

Local device names for directories and files are drive letters. Local device 
names for printers are printer ports {LPT1, LPT2, and so on). Serial devices 
{modems and plotters) may be addressed as either LPT ports or COM ports. 

The Network Resource Browser {found in the Network folder, which is located in 
the OS/2 System folder) and the OS/2 Warp Server Administration GUI enables 
you to easily assign local device names to network resources. You can create 
two types of assignments: 

• Logon Assignments: Once defined, logon assignments provide you with 
access to shared resources each time you logon. Figure 58 on page 63 
shows how you add a logon assignment for an additional directory resource. 
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Figure 58. Adding Logon Assignments 

• Current Assignments: Similar to logon assignments except that the 

assignments will only remain active for the current session and will be lost 
when the user logs off. Figure 59 on page 64 shows how you define a 
temporary current assignment. 



Chapter 3. File and Print Clients 63 







Cmtmt ;M W§%mmti£/; yy> _ .£.:i^SSI ™m 



Device Type 

!H: Directory 

I: Directory 

M; Directotig 

IK: Directoif^ 

jP: Director! 

IT: Director] 

|V: Director] 

ILRTI Printer 1 

LPT2 Printer ! 



UNC name 

\\ITOCSVMA9«RT 

WITSCSV0TMTSO 



Ad(| :;a ('urren! As.siyiiirifiiil ; 



Resource type 
iM Directory 

II Printer 

II Serial device 






Close 



Hell 



Add a new currej 



Alias or UNC name * jDISK-PRT 



Local device 



El 

j Cancel I j . 

fDevice^ ^aMign^To the 

H 






:&• 

m 

S8 



wmt 

Wt&l 



Figure 59. Adding Current Assignments 



This window is accessed by selecting your local workstation object with mouse 
button 2 from the initial window that is displayed when you start the OS/2 Warp 
Server Administration GUI and selecting Current Assignments. 



3.3 DOS File and Print Client (DOS LAN Services) 

DOS LAN Services is the component of OS/2 Warp Server that provides LAN 
connectivity for users of workstations running DOS and features some significant 
enhancements to the original version of DOS LAN Services provided with OS/2 
LAN Server 4.0. 

DOS LAN Services may function in a DOS environment with or without Windows. 
In a pure DOS environment, a graphical user interface with pull down menus is 
provided. 

In addition, the more experienced user or LAN administrator may perform 
network tasks or automate repetitive functions via NET commands from the DOS 
command line or via DOS batch files. Using NET ADMIN, an administrator at a 
DOS LAN Services workstation can manage servers remotely using the 
command line interface. 

The main features and functions of DOS LAN Services are: 

• DOS Graphical User Interface 

• Access to network resources 

• Network messaging 

• Peer Services (client single-connection resource sharing) 
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• Network DDE/Clipboard (for Windows) 

• Reduced memory requirements 

• Automatic session/optional persistent connection reconnection 

• LAN API support 

The following functional restrictions apply, such that DOS LAN Services cannot: 

• Use shared serial devices unless a serial printer is defined at the server as 
a shared parallel printer 

• Start from the DOS Shell 

• Perform remote administration of a server workstation from the GUI 

• Be installed if the DOS PATH statement would exceed 127 characters after 
adding the path for the DOS LAN Services code (DOS restriction) 

• Run when the DOS Shell is loaded 

• Run in an OS/2 emulated DOS session (VDM) 

• Change connections from a domain controller to a backup domain controller 
if the former fails 

The specific functions of each individual DOS LAN Services module are detailed 
in Table 10 on page 104. 



New Features 

DOS LAN Services was introduced with OS/2 LAN Server 4.0 and included a 
number of significant enhancements to the DOS LAN Requester shipped with 
previous versions of LAN Server. 

In OS/2 Warp Server, DOS LAN Services has been further enhanced with the 
following features: 

• Conservation of conventional memory (see “Reduced Memory 
Requirements” on page 77) 

• Remote installation enhancements (see “Remote Installation (CID)” on 
page 74) 

• Integrated TCPBEUI installation (see 3.12, “DOS LAN Services Common 
Configuration Scenarios” on page 105) 

• Support for Windows 95 (see 3.5, “Windows 95 Client (DOS LAN Services for 
Windows 95)” on page 87) 

• User Level Security for the Peer Service (see “User Level Security” on 
page 98) 

• Improved integration on OS/2 workstations (see 3.6, “Installing and Running 
DOS LAN Services on OS/2” on page 91) 

• Windows GUI Customization Options (see “Customizing your DOS LAN 
Services Windows GUI" on page 83) 

• Network drive conservation (see “DOS LAN Services Windows Shared 
Applications” on page 86) 



Chapter 3. File and Print Clients 65 




Installation 



Before you can set up DOS LAN Services, make sure that a network adapter is 
installed in your workstation and that the adapter is connected to a network. 

To install a network adapter and configure it: 

1. Verify that you have the required hardware, such as the network adapter, 
cables, connectors, and other items you will need during installation. 

2. Configure your network adapter so that it will work with your workstation. 
Some adapters must be configured before you install them. Others must be 
configured after you install them. 

3. Install the network adapter in your workstation. 

4. Connect the cables to the network adapter and to the other workstations in 
your network. 

For information about how to install your network adapter, see the 
documentation that came with the adapter. 

Previously, just to install DOS LAN Services, that was packaged with OS/2 LAN 
Server 4.0, you required approximately 500KB of conventional memory. A 
protected mode installer, capable of addressing more than 1MB of memory, has 
been added to the DOS LAN Services code that is included with OS/2 Warp 
Server. This significantly reduces the amount of conventional memory that you 
need to have available before you can install DOS LAN Services on systems with 
80286 processors or higher. 

To install DOS LAN Services, the following software is required: 

• DOS 3.3, DOS 5.02 or higher 

• OS/2 Warp Server Entry or OS/2 Warp Server 

• Microsoft Windows 3.1 (optional) 

Note: Microsoft Windows 3.0 is not supported by DOS LAN Services 
because the DOS LAN Services code base is dependent upon certain 
Windows 3.1 APIs. 

There are a number of methods that you may use to install DOS LAN Services. 

Installation from Diskette 

You may create DOS LAN Services installation diskettes from images stored on 
the OS/2 Warp Server CD-ROM. You will require four formatted diskettes which 
you should label DOS LAN Services Diskette 1 to 4 inclusive. You then simply 
copy the contents of the following directories onto each of the four diskettes: 

d:\CID\SERVER\IBMLS\IBM500Dl (DOS LAN Services Diskette 1) 
d:\CID\SERVER\IBMLS\IBM500D2 (DOS LAN Services Diskette 2) 
d:\CID\SERVER\IBMLS\IBM500D3 (DOS LAN Services Diskette 3) 
d:\CID\SERVER\IBMLS\IBM500D4 (DOS LAN Services Diskette 4) 

where d is the CD-ROM drive letter. 

If you need to install additional protocol support then you may also create a LAN 
Support Program Diskette (d:\CID\SERVER\IBMLS\IBM500Ll). 
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After you have created the DOS LAN Services product diskettes you may then 
install DOS LAN Services by inserting diskette 1 in the workstation's diskette 
drive and typing: 

a:\INSTALL 

where a is the diskette drive letter. 

Installation Switches 

One of the optional parameters (/I), that may be used with the INSTALL 
command, disables network adapter hardware detection. Use this option 
only if INSTALL will not run without it. If you use this option, you must specify 
your hardware configuration during the installation process. 

Note: DOS LAN Services does not include drivers for PCMCIA network 
adapters therefore you should install support for these adapters before 
installing DOS LAN Services with the /I switch. 

A new switch (/N) has been added to the INSTALL command. Use this option 
if your adapter and associated LAN transport components are already 
configured and you want to install the services provided by DOS LAN 
Services without changing the adapter/transport configuration. 

Additional parameters may be passed to INSTALL.BAT to aid remote 
installation. These are documented in “Remote Installation (CID)” on 
page 74. 



Default installation options are shown in Table 1 and Table 2. 



Table 1 . DOS LAN Services Installation Options Screen 1 


Installation Option 


Default Setting 


Graphical User Interface 


Install GUI 


Peer Services 


Install Peer Services 


Windows Support 


Install Windows Support 


Protocol Driver 


IBM NetBEUI 



Table 2. DOS LAN Services Installation Options Screen 2 


Installation Option 


Default Setting 


Machine ID 


Must be entered by user (15 characters or less) 


User name 


Must be entered by user (20 characters or less) 


Domain name 


Must be entered by user (15 characters or less) 


Redirector 


Use the full redirector 


Startup option 


Run DOS LAN Services and log on 


Path 


C:\NET 


Network card 


Automatically detected by DOS LAN Services 
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For a detailed explanation of each option, refer to Network Administrator 
Reference Volume 1: Planning, Installation and Configuration which is shipped 
with OS/2 Warp Server as an installable online book. 

Note: If you reinstall Windows or modify the DOS LAN Services configuration file 
{NETWORK.INI) you must run the DOS LAN Services install program 
{INSTALL.BAT). Also note that DOS LAN Services cannot be run from the DOS 
shell. Therefore, you should either remove the DOSSHELL statement from your 
AUTOEXEC.BAT or move it to run after the DOS LAN Services statements. 

While referring to this section for additional guidance, follow the installation 
instructions displayed on the screen and select the options that best suit your 
requirements. 

If you experience any problems installing DOS LAN Services then you will find 
hints and tips in the file CONNECT.TXT in the directory where DOS LAN Services 
was installed. 

Installation from the OS/2 Warp Server CD-ROM 

Alternatively, if you have a CD-ROM attached to your DOS/Windows workstation 
you may install DOS LAN Services by typing: 

d:\DOS\CLIENT\INSTALL 



where d is the CD-ROM drive letter. 

The installation procedure then follows the same flow as if you were remotely 
installing from an OS/2 Warp Server server, as described in “Remote Installation 
{from an OS/2 Warp Server),” but without the steps necessary to establish a 
remote connection. 

Remote Installation (from an OS/2 Warp Server) 

As is the case with the OS/2 file and print client, you may remotely install the 
DOS/Windows file and print client across the LAN from images stored on the 
server workstation's hard drive or CD-ROM. You can do this by generating a 
DOS Remote Installation Diskette by following the procedure detailed in 2.8, 
“Preparing the Server for Client Installation” on page 28 and select Windows 
workstation on the screen shown in Figure 28 on page 29. 

Remote Installation Prerequisites 

To perform a remote installation of a Windows workstation you must have 
DOS and Windows 3.1 or Windows for WorkGroups already installed. 



After generating your DOS Remote Installation Diskette you simply take it to your 
LAN attached DOS/Windows workstation and type: 

a:\INSTALL 

where a is the diskette drive letter. 

Note: If your system appears to hang please verify that when you created the 
DOS Remote Installation Diskette you selected the correct network adapter. 
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The OS/2 Warp Server installation program will then copy files required for the 
remote installation to the C:\WSINST directory on the workstation and, depending 
on the current workstation configuration, you may need to select the option to 
install the remote connection support unless you are running one of the 
following: 

• PC LAN Support Program Version 1.3 or later 

• DOS LAN Requester Version 2.0 or later 

• DOS LAN Services Version 4.0 or later 

• Microsoft LAN Manager 2.x DOS Client 

• Microsoft Windows for WorkGroups Version 3.11 

If you are running one of the above on your workstation then you must ensure 
that the network software is started before beginning the OS/2 Warp Server 
Windows client installation. 

If not, then you need to install the remote connection support which will modify 
your system configuration and automatically restart the workstation. After the 
system restarts you may continue the remote installation by starting Windows 
and selecting the Windows Client Installation program icon from the WS Remote 
Installation program group. 

Note: The remote connection support is provided by a subset of DOS LAN 
Services. 




OS/2 Warp Server Windows Client 



Welcome to the OS/2 Warp Server Windows client 
installation. 

Select one or more clients to install on your 
workstation. 



I I DOS Fite and Flint Client (DO S LAO Services 

LX: System Management Client (SystemView) 

El Remote Access Client (LAN Distance) 




Figure 60. Windows Client Remote Installation - Client Selection 

After the remote installation files have been copied over when you next start 
Windows you will be presented with the screen shown in Figure 60. 

Note: In this example the target workstation already had the DOS File and Print 
Client installed and therefore was not selectable. 

After specifying the client components that you wish to install you will then be 
ready to begin the installation process. In this instance the first client 
component that you are prompted to install is the SystemView Windows client. 
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Figure 61. SystemView Windows Client Installation 




Figure 61 and Figure 62 show what you are presented with when you select the 
SystemView for Windows client and Figure 63 on page 71 shows the resulting 
program group after installation. For a detailed discussion of the SystemView for 
Windows components please refer to Inside OS/2 Warp Server, Volume 2: Using 
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SystemView, Backup/ Recovery and Advanced Print which is planned to be 
available in May 1996. 

Note: If the following message is received during the OS/2 Warp Server 
Windows Client installation: 



“STOP" It was not possible to write the distribution configuration 
due to TCP/IP (or NetBIOS) Problems. 



Select Cancel. After you complete the installation, open the SystemView icon 
and re-configure these protocols. 
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Figure 63. SystemView for Windows Program Group 

After the SystemView client is configured and installed you are then 
automatically prompted to configure and install the Remote Access client. 
Figure 64 on page 72 through Figure 69 on page 74 show some of the screens 
that guide you through the Windows Remote Access client installation. For a 
detailed discussion please refer to 7.6, “Setting Up a Windows Remote Access 
Services Client” on page 317. 
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Modem type 



Select the modem used on your workstation. 



Modem Type: 



r*..Any. Mod e m N ot j n This List 



Angia Id. 4 Data/Fax Modem 
Apex Freedom 14/96 Data/Fax Laptop Modei| 
Apex PCA PCMCIA Fax/Modem IBP-1 41 4 
Apex PCR PCMCIA Fax/Modem IBP-1 41 4 
Asynchronous Switched Connection Modem 
AT&T Comsphere 3811 Plus 



m 

I 







Figure 64. Windows Remote Access Client - Select Modem Type 



Serial Port 



Select the serial port to which your modem is connected. 
Serial Port: 



CO Ml 



COM2 




Figure 65. Windows Remote Access Client - Specify Serial Port 



72 Inside OS/2 Warp Server, Volume 1 




m f 
mik 



Phone number 



Enter the phone number of the LAN Distance workstation 
you want to dial. 




Figure 66. Windows Remote Access Client - Specify Phone Number 



B LAN Type 



Specify the type of LAN you will connect to when using the 
LAN Distance Product. 



® jlE EE 802.5 Token Riingj 
O IEEE B02.3 Ethernet 
Select Help for additional information. 




Figure 67. Windows Remote Access Client - Select LAN Type 
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Logical Adapter Network Addre 



The LAN Distance product requires a unique logical 
adapter network address. This address is equivalent to a 
Token-Ring or Ethernet adapter address and must be unique 
for ail workstations within your LAN Distance environment. 
You may obtain this address one of two ways: 

- From your LAN administrator and enter this value below. 

- Select Generate. The system will enter a logical 
adapter network address for you. You MUST then copy 
this number and deliver it to your LAN administrator. 




Figure 68. Windows Remote Access Client - Generate Logical Adapter Address 



Enable Netware 



The IBM LAN Distance product includes support for Novell NetWare Client for 
DOS/Windows vl .01 . 



If you have an earlier version of the NetWare requester, please press the help 
button for upgrade information. 

If the NetWare Client vl. 01 is installed and you want to enable it for LAN 
Distance, select Enable NetWare Requester support. 



O Enable NetWare Requester support 
<S>|Qisabie NetWare Requester support] 




Figure 69. Windows Remote Access Client - Enable NetWare Support 



Remote Installation (CID) 

DOS LAN Services clients are CID-enabled to allow for attended, lightly attended 
and unattended installation from a code server. This is quite different from the 
native OS/2 Warp Server remote installation method which is discussed in 
“Remote Installation (from an OS/2 Warp Server)” on page 68. 
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Previously, in order to perform a remote installation of a system with no 
operating system installed, you needed to setup a SRVIFS code server and 
produce two remote installation boot diskettes that contained an OS/2 and 
SRVIFS client. 

In this latest version of DOS LAN Services you may now create one remote 
installation boot diskette which contains DOS, the DOS LAN Services client and 
LAN Support Program (LSP) transport. Since DOS LAN Services uses native 
LAN Server protocols, it is not necessary to have SRVIFS on the code server. 

To aid remote installation the following option switches have been added to the 
DOS LAN Services INSTALL command: 

• [/LI] enables you to specify where you want the remote error log file to be 
stored. For example: 

INSTALL /LI: C:\DLS. ERR 

• [/L2] enables you to specify where you want the remote history log file to be 
stored. For example: 

INSTALL /L2: C:\DLS. HIS 

• [/R] is required for remote installation and specifies where the DOS LAN 
Services response file is stored. For example: 

INSTALL /R : C : \DLSRSP\DLS . RSP 

Implementation of this new feature has also added new command line options to 
the NET START and NET LOGON commands in DOS LAN Services. 

The new option switches for NET START are: 

• [/COMPUTERNAME:{name | *}] temporarily replaces the computername 
parameter specified in NETWORK.INI. The asterisk (*) prompts for the 
automatic random generation of a temporary name for the computer. 

• [/AUTOLOGON: NO] temporarily modifies the autologon behaviour of the 
requester. Only an override of NO is allowed. 

The new option switches for NET LOGON are: 

• [/LSL0G0N:N0] temporarily changes the validated logon behaviour of the 
requester. Only an override of NO is allowed. 

• [/GENID] temporarily overrides the user name specified in NETWORK.INI with 
an automatically randomly generated user name. 

— /GENID is mutually exclusive with a user ID and/or password specified on 
the command line. 

— /GENID automatically includes /PWCACHING:NO. 

— /GENID automatically surpresses prompting (/YES). 

• [/PWCACHING:NO] temporarily changes the the password caching behavior as 
specified in NETWORK.INI. Only an override of NO is allowed. 

Response File Parameter Reference: The following table provides information 
on the keywords that you may use in the response file for DOS LAN Services CID 
installation. 
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Table 3. DOS LAN Services Remote Installation - Response File Keyword Reference 


Keyword 


Description 


Valid Values 


Default 


configsys 


Where CONFIG.SYS is located 


A valid path 


C:\ 


autoexecbat 


Where AUTOEXEC.BAT is 
located 


A valid path 


C:\ 


target 


Drive and directory to install 
DOS LAN Services 


A valid path 


C:\NET 


peer 


Switch for installing Peer 
support 


Yes, No 


No 


windows upport 


Switch for installing Windows 
support 


Yes, No 


No 


gui 


Switch for installing GUI 
support 


Yes, No 


No 


install802 


Switch for installing 802.2 
support. If this switch is set to 
Yes, LAN Support Program 
(non-NDIS) will be loaded. 


Yes, No 


No 


computername 


The name that identifies the 
workstation to the network 


Up to 15 alphanumeric 
characters or special 
characters including ! # 
$ % & ( ) 0 _ { } A ' - 


You must 

supply 

this 

information 


domainname 


The name that identifies the 
domain that this workstation 
belongs to 


Up to 15 alphanumeric 
characters or special 
characters including ! # 

$ % & ( ) 0 _ { } A ' ~ 


You must 

supply 

this 

information 


username 


The name that identifies you to 
the network 


Up to 20 alphanumeric 
characters or special 
characters including ! # 
S % & ( ) 0 _ { } A ' ~ 


You must 

supply 

this 

information 


networkcard 


DOS LAN Services will try to 
automatically detect your 
network card so this parameter 
will, in most instances, not be 
needed on your system. If you 
specify this parameter in your 
response file, DOS LAN 
Services will install the driver 
for the card specified. 


See Network 

Administrator's 

Reference 


No 

parameter 

specified 



Sample DOS LAN Services Response File: The following is the sample 
DLSNEW.RSP response file included with DOS LAN Services which may be found 
on DOS LAN Services Diskette 1. 
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[dlsmain] 

computername=j i msmach 

configsys=c: 

username=jimmyp 

domai nname=kawasaki 

autoexecbat=c: 

target=d:\net 

peer=yes 

redi recter=ful 1 

windows upport=yes 

gui=yes 

[dlsdri ver] 

ncbs=30 

sessions=33 



Figure 70. Sample DOS LAN Services Response File 



Reduced Memory Requirements 

Given the limitations imposed by DOS on real mode memory, it is obviously 
critical to minimize the use of it. Continuous efforts are focussed on increasing 
the amount of memory available for applications. The result is that on an 
8086/8088-based workstation configured as a basic redirector running DOS 3.3 
with LAN Support Program, 496KB of conventional memory remains available to 
applications. DOS LAN Services, as shipped with OS/2 Warp Server, 
incorporates a protected mode redirector which provides a similarly configured 
386 or 486 workstation, running PC-DOS 7.0, with 621KB of real mode memory 
available. 

Even running the protected mode redirector results in 598KB of memory 
available to DOS applications! 

Note: The above values are based on 110KB of Upper Memory Block (UMB) 
space. These values represent the amount of conventional memory that is 
available after loading the LAN Transport and DOS LAN Services redirector. 

DOS LAN Services Fixes 

To get the DOS LAN Services enhancements and fixes described in this 
chapter for existing OS/2 LAN Server 4.0 DOS clients, contact your IBM 
customer service representative and ask to be sent fixes relating to APAR 
IC10086 or obtain OS/2 LAN Server 4.0 Service Pack IP08150 which includes 
the DOS LAN Services enhancements/fixes that are included in OS/2 Warp 
Server. 

If you are in doubt as to whether you have DOS LAN Services with the 
protected mode redirector then check for the file CMDS16.EXE in the 
directory where you have DOS LAN Services installed. If you have this file 
then you have the protected mode redirector. 



In a Windows environment, DOS LAN Services does not actually use any real 
mode memory when configured as a virtual redirector, since it runs as a 
Windows virtual device driver. 
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The following sample files illustrate how you may configure a system to have 636 
368 bytes (621 KB) of memory available to DOS applications after loading LAN 
transport and DOS LAN Services, with FILES=30 and LASTDRIVE=H. 

Note: In this example, LAN Support Program has been used to minimize 
memory utilization. For optimum performance, IBM NetBEUI is recommended 
(the default when you install DLS). 

These sample files were taken from an IBM PS/VP with 8MB of RAM and an IBM 
Auto 16/4 Token Ring ISA Adapter installed. The amount UMB space available 
will vary depending on the hardware configuration of the system since hardware 
drivers are loaded into this memory area. 



DEVI CE=C : \D0S\H IMEM .SYS 








DOS=HIGH,UMB 








DEVI CE=C: \00S\EMM386.EXE NOEMS RAM 


< — See 


Note 


1 


FILES-30 < 


See 


Note 


2 


BUFFERS-20 < 


See 


Note 


3 


DEV I C EH I GH=C : \LSP\DXMA0MOD .SYS 








DEVICEHIGH=C:\LSP\DXMC0MOD.SYS 








DEVICEHIGH=C:\LSP\DXMT0MOD.SYS 








LASTDRIVE-H < 


See 


Note 


4 


STACKS=0,0 < 


See 


Note 


5 


DEVICEHIGH=C:\NET\DLSHELP. SYS <— 


See 


Note 


6 



Figure 71. Sample CONFIG.SYS for Maximum Memory Availability 



0ECHO OFF 
PROMPT $P$G 

PROMPT C:\;C:\DOS;C:\NET; 
C:\NET\NET START 



Figure 72. Sample AUTOEXEC.BAT for Maximum Memory Availability 



[network] 




computername=DLSREQ01 




lanroot=C:\NET 




autologon=no 




autostart=basic < 


See Note 7 


guiconfig=0,0,l 




username=USERl 




domain=TESTD0M4 




lslogon=yes 




reconnect=yes 




passwordcachi ng=yes 




timesync=yes 




[Password Lists] 




USER1=C : \NET\USER1 . PWL 




[Domain List] 




TESTD0M4= 





Figure 73. Sample NETWORK. INI for Maximum Memory Availability 
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Notes: 

1. Memory include and exclude parameters are omitted from the example. 

2. This represents a typical value to support most environments. The 
implications on memory utilization of adjusting this value are negligible. 

3. Buffers are loaded into upper memory, where available, and therefore there 
is no impact on real mode memory unless the amount of UMB space is 
limited. 

4. Each additional drive letter consumes between 80-100 bytes, and, therefore, 
you should plan your network logon assignments to maximize the available 
memory at the workstation. 

5. Setting the value of stacks to 0,0 conserves memory but may cause 
problems on certain systems. Reset back to the default if your system 
appears unstable. 

6. This driver provides an interface to the redirector. It handles hooking 
interrupts and some initial setup work. Without this driver, DOS LAN 
Services will not function. 

7. The basic redirector program only supports basic network functions such as 
connecting, disconnecting and browsing of shared resources. If additional 
function is required, such as the GUI or peer services capability, then you 
will require the full redirector. Refer to the OS/2 Warp Server Commands 
and Utilities publication (available as online documentation; resides in the 
LAN Services File and Print folder) for details of the restrictions on the use of 
the NET USE command with the basic redirector. 

Selecting the Redirector 

It is important to understand the differences between the types of redirectors 
available: 

Basic Redirector: Provides all standard requester functions, such as connecting, 
disconnecting and browsing. It requires less memory and disk space and should 
therefore be used if you: 

• Have a workstation with limited processing power, such as an 8086 or 8088 

• Cannot use the protected mode redirector 

• Have limited memory available on your workstation 

• Do not wish to use aliases to identify resources 

• Do not plan to use Windows 

Full Redirector: Provides advanced network functions, such as named pipes, as 
well as increased performance and full API support. 

Protected Mode Redirector: Provides the same level of functionality as the full 
redirector but consumes less conventional memory by loading DOS LAN 
Services into upper memory. 

Virtual Redirector: Provides the optimum memory availability since it does not 
use conventional memory, because it runs as a Windows virtual device driver. 

Note: Even if you run the full redirector before starting Windows, the virtual 
redirector will load providing SYSTEM.INI has the correct statements in the 
[386Enh] section. 
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With DOS LAN Services installed on a workstation running Windows you are 
provided with seamless access to all of the features of DOS LAN Services from 
the Windows graphical user interface. 



Configuration 

Once you have successfully installed DOS LAN Services you may then start the 
requester by typing NET START. The following options are available, although 
generally do not need to be used: 



Table 4. DOS LAN Services NET START Options and Initialization Process 


Option 


Function 


Initialization Process 


BASIC 


Starts the basic redirector 


NET.EXE executes: 

• NETWKSTA.EXE (within 
NET.EXE) 

• NETBEUI.EXE (within 
NET.EXE) 


FULL 


Starts the full redirector 


NET.EXE executes: 

• REDIR.EXE (within NET.EXE) 

• NETBEUI.EXE (within 
NET.EXE) 


REQUESTER 


Starts the default redirector 


Depends on which redirector is 
configured 


PEER 


Starts the Peer service 


NET.EXE executes: 

• SHARE.EXE (if not already 
loaded) 

• PEER.EXE 


NETBIND 


Binds protocols and network 
card drivers 


NET.EXE executes the NETBIND 
command 


NETBEUI 


Starts the NetBIOS interface 


NET.EXE executes NETBEUI.EXE 
(within NET.EXE) 


MESSENGER 


Starts the Messenger service 
(requires the FULL redirector) 


NET.EXE executes 
MESSENGER.EXE 


NETPOPUP 


Starts the Netpopup service 
(requires the FULL redirector 
and Messenger service) 


NET.EXE executes 
NETPOPUP.EXE 


/LIST 


Displays a list of the requester 
components that have been 
started 


Not applicable 


/YES 


Executes the NET START 
command without prompting for 
information or asking for 
confirmation of actions 


Not applicable 



Graphical User Interface 

As previously mentioned, you may access network resources from DOS 
workstations by using any of the three interfaces provided by DOS LAN Services: 

• DOS LAN Services graphical user interface 

• Windows interface 

• Command line interface (the DOS command prompt) 
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The graphical user interface provided with DOS LAN Services supports DBCS 
and mouse input. It can be used on DOS clients with or without Windows and 
enables you to perform the following tasks: 

• Log on and log off to/from a LAN Server domain, modify logon assignments 
and re-establish persistent connections, if you have any 

• Change logon password and user comment 

• List users logged on to the domain 

• Modify the appearance of the graphical user interface 

• Share directories and printers with other users on the network 

• View directory-limit information for a shared directory 

• Send and receive network messages 

• Define private and public applications 

The DOS LAN Services graphical user interface may be run in graphics mode on 
any monitor/video adapter combination supporting VGA graphics or higher. The 
graphical user interface will gain no benefit from higher resolution graphics. 

If a workstation does not support VGA, the graphical user interface may be run 
in text mode by specifying the /T switch after the NETGUI command. 

The DOS LAN Services graphical user interface is packaged with DOS LAN 
Services and is presented as an installation option of DOS LAN Services. Unless 
otherwise specified, it is installed by default. 



3.4 Windows File and Print Client (DOS LAN Services Windows Support) 

When implemented on a system running DOS and Windows, DOS LAN Services 
enables you to access network resources through the Windows graphical user 
interface, as shown in Figure 74. 
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W4602R10 

ITSCAUS 



Figure 74. DOS LAN Services Windows GUI 

DOS LAN Services Windows enables you to: 

• Logon and logoff 

• Change password 

• Change user description 
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• View logged on users 

• Modify logon assignments 

• View, connect to, and disconnect from OS/2 Warp Server shared resources 

• View, install and use OS/2 Warp Server shared applications 

• Send and receive messages 

• Manage print jobs in shared print queues 

• View directory limit information for a shared directory 

• Share local directories and printers 

The following restrictions apply, such that you cannot: 

• Define private applications 

• Logon or logoff a media-less remote initial program load (RIPL) requester 

• Start the virtual redirector if Windows is loaded from a network drive 

• Use the BASIC redirector 

• Work with Windows 32-bit file access 

• Work with 32-bit NDIS VXD device drivers 



Installation 

When you install DOS LAN Services, as described in “Installation” on page 66, 
you will install Windows Support by default. If you have Windows already 
installed on the system then a run = dlssetup statement will be added to the 
Windows WIN. INI file which will be replaced with run = wells after installation. 

When you next start Windows DLSSETUP.EXE will make the following 
modifications to the Windows SYSTEM.INI file in the sections listed: 

[Boot] 

NETWORK. DRV=DLSNET. DRV 

[Boot.Descri ption] 

NETWORK. DRV=IBM DOS LAN Services 

[386Enh] 

NETWORK=vnetbi os . 386, vnetsup. 386,vredi r. 386 

In addition, a DOS LAN Services program group will be created. 

Notes: 

1. If you install Windows on a system which already has DOS LAN Services 
installed you can make the above modifications by starting Windows, 
selecting Files from the Program Manager action bar, then select Run, and 
then type in C:\NET\DLSSETUP.EXE assuming that you installed DOS LAN 
Services with Windows Support before. 

2. Even if you run the full redirector before starting Windows, the virtual 
redirector will load assuming SYSTEM.INI has the correct statements in the 
[386Enh] section. 
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Configuration 



Following installation, DOS LAN Services may be configured via the Network 
program icon located in the Windows Control Panel. The DOS LAN Services 
Configuration window, as shown in Figure 75, enables you to modify options for 
logging on at startup, resource sharing, and network warnings. 



I 






Ir ».■?& 



DOS LAN Services Configuration 



'Logon at Startup 

©I Ena ble lo go n a t Wind o ws St a rt up; 
O Disable logon at Windows Startup 



Resource Sharing 

© Enable sharing from File Manager 
O Disable sharing from File Manager 



IBM DOS LAN Services 
Version 5.0 



Copyright © 1995 IBM Cotp. 
Copyright © 1 992 Microsoft Corp. 



Network Warning 

© Enable warning when network not started 
O Disable warning when network not started 









Figure 75. DOS LAN Services Windows Configuration Window 

The DOS LAN Services group contains program icons to enable you to logon, 
logoff, start the Network DDE and Clipboard feature, and access the DOS LAN 
Services main window. All of the functions accessible from DOS LAN Services 
DOS graphical user interface are available and integrated into the Windows 
environment. For example, if you select the Printers pull-down menu, you are 
provided with direct access to the Windows Print Manager. 



Customizing your DOS LAN Services Windows GUI 

It is possible to customize your DOS LAN Services Windows GUI appearance and 
also restrict access to menu bar items by creating an optional .INI file. This is of 
particular use where you want to provide a standard workstation configuration 
tailored to enable users to perform their job whilst preventing them from 
modifying their logon assignments, connections, and so on. 
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IBM DOS LAN Services 
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Domain: ITSCAUS 



Figure 76. DOS LAN Services Windows GUI 

It is also possible to hide the DOS LAN Services Windows GUI interface so that 
they may only logon and logoff using icons from the DOS LAN Services program 
group. 

This has been achieved by modifying WDLS.EXE so that it automatically searches 
for a file called WDLS.INI in the directory where DOS LAN Services has been 
installed. 

Note: WDLS.INI (as well as any other .INI file) can be a hidden file, enabling an 
administrator to reduce the possibility of a user finding the file and changing the 
settings. 

The sample WDLS.INI in Figure 77 shows the default values. 

Note: A default WDLS.INI file is not included with DOS LAN Services If you wish 
to customize your menu appearance then you need to create one. You do not 
need to include all default definitions just the section headings and the relevant 
entries that you wish to change. 



[MenuBar] 

User=l 

Appl ications=l 
Dri ves=l 
Printers=l 
Messages=l 
Help=l 

[MainWindow] 

HideMainWindow=0 

ShowNormalAtStartup=l 

ShowNormal AtLogon=l 

LogonAtStartup=l 

Toolbar=l 



Figure 77. Sample DOS LAN Services Customization File 

Each entry in the [MenuBar] section can be used to selectively disable/enable 
menu bar items in the DOS LAN Services main window (provided that the 
service associated with the menu item is started). A value of 0 will disable the 
menu item (the default is to display the menu item ( = 1)). 



84 Inside OS/2 Warp Server, Volume 1 






If you compare the DOS LAN Services Windows GUI shown in Figure 78 on 
page 85 with the default GUI shown in Figure 76 you will see the results of 
setting the values of [MenuBar] Applications, Drives, and Printers entries and the 
[MainWindow] Toolbar entry to 0. 

By making these modifications to the WDLS.INI file you could prevent users from 
modifying their logon assignments. 



IBM DOS LAN Services 



User Applicators Doves Printers Messages Help 



User ID: 


A948R1 


Machine ID: 


W4602R1D 


Domain: 


ITSCAUS 



Figure 78. Customized DOS LAN Services Windows GUI 



The [MainWindow] section has five entries. HideMainWindow (0 = default = no) can 
be used to hide the DOS LAN Services main window completely. This enables 
you to provide only logon and logoff functions by creating program icons which 
call WDLS.EXE with the appropriate parameter as detailed in Table 5. 

LogonAtStartup enables you to suppress the logon panel at startup if a user is not 
already logged on and Toolbar is used to specify whether or not a toolbar is 
displayed as part of the DOS LAN Services Graphical User Interface. 



Table 5. DOS LAN Services WDLS.EXE Parameter Functions 


Parameter 


Function 


0 


Logon 


1 


Logoff 


2 


Start DOS LAN Services Windows Graphical User Interface 


3 


Manage Shared Applications 


4 


Change User Comment 


5 


Manage Drive Connections 


6 


Manage Printer Connections 


7 


Share Directories 


8 


Share Printers 


9 


Send Message 



The ShowNormalAtStartup and ShowNormal At Logon entries control how the DLS main 
window behaves when Windows is started and when a user logs on. The current 
{and default) behavior is that the DLS main window appears centered on the 
desktop in both situations. These entries can be set to 0 {1 = default) to have the 
main window always minimized as an icon, until the user selects the icon, which 
restores the main window to the center of the desktop. 
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Note: If HideMainWindow is set to 1 (main window is hidden), then the 
ShowNormalAtStartup and ShowNormalAtLogon entries have no effect. 

DOS LAN Services Windows Shared Applications 

DOS LAN Services that is included with OS/2 Warp Server features 
enhancements to how Windows applications are accessed. Previously, 
RUNLSAPP.EXE, the public applications launcher for the DOS LAN Services 
Windows GUI, required a drive letter to be assigned to a program alias to start 
the Windows application. 

The problem with this was that you were liable to run out of available drive 
letters in an environment where many shared directories and applications were 
being accessed. 

To remove this problem, an undocumented feature of the Windows API, 
WinExec(), is used which accepts UNC paths for paths to programs. This 
enables Windows applications to be accessed in the same way as OS/2 public 
applications. RUNLSAPP.EXE has also been enhanced to support additional 
printer assignments associated with public applications. 

DOS LAN Services General Hints and Tips 

Attention 

The additional hints and tips in this section are taken from the OS/2 Warp 
Server README. 1ST file. Please review this file as it contains important 
information relating to other key OS/2 Warp Server components. 



Upgrading from DOS LAN Services Version 4.0 

Run TCPSTOP before installing OS/2 Warp Server client software on a workstation 
that already has DOS LAN Services 4.0 and IBM TCP/IP for DOS installed. If you 
do not stop IBM TCP/IP for DOS, a TRAP exception will occur when the INSTALL 
program for DOS LAN Services 5.0 starts. 

Pressing Ctrl-C During NET LOGON 

After running the NET LOGON command in a Windows DOS prompt, do not press 
Ctrl-C at the workstation password prompt. Doing so causes a general 
protection fault (GPF). 

System Hangs Exiting Windows 

If the Peer service has been started and the system hangs when you exit 
Windows, try increasing the size of the STACKS command in the CONFIG.SYS file. 

File Copies Stop Exiting Windows 

Do not exit Windows while the Peer service is running if a client is copying files 
from your DOS peer workstation. If you exit Windows while a copy is in 
progress, the copy will stop. 
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Memory Restrictions With Multiple LAN Transports 

If you select both the NetBEUI and TCPBEUI real-mode transports when you 
install DOS LAN Services, you might not be able to start Windows. This is 
because of memory requirements below 640K. With both transports installed, 
Windows will not start if the Peer service is running, or if the Full redirector is 
running with the Messaging and Netpopup services. Windows will start if only 
the Full redirector and Messaging service are running. 

If you install only NetBEUI or only TCPBEUI, but not both, then you can start 
Windows with all DOS LAN Services services running. 



Extended ASCII Characters Not Supported 

If you use extended ASCII characters {decimal codes 128-255) to name a network 
resource, users at DOS/Windows workstations might not be able to display or 
use that resource in DOS LAN Services in Windows or in the DOS LAN Services 
&guil.. This is because of the way character sets are converted for display on 
different workstations. 

DOS LAN Services in Windows does not support extended ASCII characters 
(decimal codes 128-255) that do not have equivalents in the ANSI character set. 
This is a current restriction of Windows. Windows converts most unsupported 
characters to either an underscore or vertical bar. Refer to your Windows 
documentation for information about the ANSI character set. 



On DOS LAN Services workstations that use code page 437 to display characters 
(primarily in the United States) the DOS LAN Services &guil. does not support 
the following extended ASCII codes (decimal): 



155 




226-229 


249 


157 - 


■159 


231-240 


251 


169 




242-245 


252 


176 - 


■224 


247 


254 



3.5 Windows 95 Client (DOS LAN Services for Windows 95) 

The DOS LAN Services for Windows 95 component allows your system running 
Microsoft Windows 95 to access IBM OS/2 LAN Server functions such as Aliases, 
Directory Limits, Shared Applications, and so on. This product is an add on to 
the Windows 95 Microsoft Network function. It gives you all of the LAN Server 
Server function, in addition to what Windows 95 provides. 
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Figure 79. DOS LAN Services in a Windows 95 Environment 



Installation 

DOS LAN Services for Windows 95 may be installed from either a diskette 
created from an image on the OS/2 Warp Server CD-ROM (contents of 
d:\CID\CLIENT\DLS4W95) or directly from the CD-ROM. 

Follow these steps to install DOS LAN Services for Windows 95 on your 
computer from the diskette: 

1. Insert the DOS LAN Services for Windows 95 diskette into the A: drive 

2. Select Start from the Windows 95 Task Bar 

3. Select Settings 

4. Select Control Panel 

5. Double click on Add/Remove Programs 

6. Select the tab titled Windows Setup 

7. Select push button Have Disk... 

8. Select OK from the Install From Disk menu 

9. Check the box next to DOS LAN Services for Windows 95 
10. Select push button Install 
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Figure 80. DOS LAN Services for Windows 95 installation 

After installation, DOS LAN Services will appear on the Task Bar in the 
Programs menu. 

Follow these steps to install DOS LAN Services for Windows 95 on your 
computer from the OS/2 Warp Server CD-ROM: 

1. Insert the CD ROM into your CD-ROM drive 

2. Select Start from the Windows 95 Task Bar 

3. Select Settings 

4. Select Control Panel 

5. Double click on Add/Remove Programs 

6. Select the tab titled Windows Setup 

7. Select push button Have Disk... 

8. Type in the drive of your CD-ROM followed by the path to the DOS LAN 
Services for Windows 95 directory, for example: 

d:\CID\CLIENT\DLS4W95 

9. Select OK from the Install From Disk menu 

10. Check the box next to DOS LAN Services for Windows 95 

11. Select push button Install 
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After installation, DOS LAN Services will appear on the Task Bar in the 
Programs menu. 



Graphical User Interface 

To start the DOS LAN Services for Windows 95 GUI select DOS LAN Services for 
Windows 95 from the Program menu which you access from the Windows 95 
Task Bar. 



You will be presented with the DOS LAN Services for Windows 95 Graphical User 
Interface as shown in Figure 81. 
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Figure 81. DOS LAN Services for Windows 95 Graphical User interface 

Note: You may customize the appearance of the DOS LAN Services for 
Windows 95 GUI in the same way as you can for the DOS LAN Services Windows 
GUI as described in “Customizing your DOS LAN Services Windows GUI’’ on 
page 83. 



Accessing LAN Server Functions 

You access the LAN Server NET commands by using the NETLS command. This is 
done to supplement the Microsoft NET commands. The following commands are 
supported using the NETLS command from an MS-DOS command prompt: 



NET ADMIN 


Runs a command or starts a command processor on a 
server from a workstation. You must have administrative 
privilege at the server to use this command. 


NET ALIAS 


Displays a list of aliases on a specified domain or 
information on a specific alias. 


NET DASD 


Displays directory limits for the maximum usable disk 
space for a remote HPFS386 logical drive. 


NET HELP 


Provides information about commands and error 
messages. 


NET SEND 


Sends messages to other computers or users on the local 
area network. 


NET USE 


Connects to or disconnects from a shared resource or 
displays information about connections. 


NET WHO 


Lists usernames logged on in a domain or a server, and 
displays information about individual users. 



If you would like to access all NET commands using NET.EXE you will need to 
run DLSNET.BAT with the parameter Y. This batch file renames the Microsoft 
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NET. EXE program to NET95.EXE, and NETLS.EXE to NET.EXE. The DOS LAN 
Services for Windows 95 NET.EXE (NETLS.EXE) will execute the commands listed 
in the previous section. If the command is not one of these it will send the 
command to the Microsoft NET95.EXE program to be processed. 

The Windows 95 Network Neighborhood 

For OS/2 LAN Server and OS/2 Warp Server workstations to appear in the 
Network Neighborhood you need to configure at least one workstation in the 
domain to run File and Printer Sharing for Microsoft Networks and act as the 
Browse Master. The workstation (s) should be modified in the following way: 

1 Select Control Panel from the Task Bar (Start) 

2. Select Network 

3. Highlight File and Printer Sharing for Microsoft Networks and press the 
button Properties 

4. Set the Property Browse Master to the Value Enabled 

5. Set the Property LM Announce to the Value Yes 

6. Select the OK button on the File and Printer Sharing for Microsoft Network 
Properties panel 

7. Select the OK button on the Network panel 

Once you have completed these steps you need to restart the system to activate 
the changes. 

Sharing Restrictions in non-NT Domains 

If you log on to a non-NT domain or workgroup from a Windows 95 peer 
workstation, you can use only share-level access control for shared files and 
printers. If you attempt to set user-level access, the list of users cannot be 
displayed. 



3.6 Installing and Running DOS LAN Services on OS/2 

Previously it has not been possible to use the DOS LAN Services Windows 
network driver (DLSNET.DRV) with WIN-OS/2 and VNETAPI.OS2 and you have 
had to resort to the Microsoft LAN Manager 2.x Windows network driver 
(LANMAN.DRV) in order to communicate with LAN Server. However, 
LANMAN.DRV does not have support for browsing and connecting to aliases, 
running public applications, and so on. If you wanted to connect to an alias for 
you to use in a WIN-OS/2 session, you had to switch to OS/2, make the 
connection, then switch back to the WIN-OS/2 session. Also you could not run a 
public application from within a WIN-OS/2 session. 

Incompatibilities between DLSNET.DRV and VNETAPI.OS2 have been resolved 
and design changes to the Windows GUI have made it compatible with 
VNETAPI.OS2. This now provides users of OS/2 LAN Requesters the ability to 
connect to LAN Server resources from each WIN-OS/2 session without having 
DOS LAN Services installed and enables them to run DOS and Windows public 
applications from each WIN-OS/2 session. A full installation of DOS LAN 
Services is not required, only the DOS LAN Services Windows program files and 
drivers are required. 
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Note: This implementation removes the requirement for DOS LAN Services to 
run in each WIN-OS/2 session, since VNETAPI.OS2 virtualizes the LAN Server 
APIs called by DLSNET.DRV, thereby conserving system memory and adapter 
resources. 

Installing DOS LAN Services on OS/2 

The following procedure describes how to set up your system to access network 
resources (aliases or netnames), and network applications from a WIN-OS/2 
session. This procedure installs the drivers and code needed to support the 
DOS LAN Services Windows interface. By using the DOS LAN Services Windows 
drivers and Windows GUI, you will have access to many functions usually 
available only when the full DOS LAN Services product is installed. Network 
functions within the WIN-OS/2 File Manager and Print Manager are also enabled 
within each DOS session, including the ability to browse network resources, and 
manage print jobs on remote queues. 

Before beginning this procedure, check to see that you have the following 
prerequisite software installed: 

• WIN-OS/2 (provided with OS/2) 

• OS/2 LAN Requester 

• Virtual DOS LAN API Support (VNETAPI.OS2, by default, is installed with 
OS/2 LAN Requester). 

If you need to install OS/2 LAN Requester or the Virtual DOS LAN API Support 
option, use the Advanced LAN Services Installation/Configuration path to do so 
before continuing with this procedure (see Figure 5 on page 12). 

The following steps explain how to complete your setup by installing the DOS 
LAN Services Windows drivers and Windows GUI code needed for your WIN-OS/2 
session: 

• To install the DOS LAN Services Windows drivers and Windows GUI code to 
run with Virtual DOS LAN API Support: 

1. From an OS/2 command prompt type: 

VNETOLS 

Note: Type VNETDLS /? or VNETDLS HELP to see the valid parameters and 
syntax for this command. 

2. Follow the instructions displayed on the panels; you will be prompted to 
provide configuration information. 

The program installs the required DOS LAN Services Windows files from 
either diskette or CD-ROM to your hard-disk. 

Notes: 

1. DLSSETUP.EXE builds the DOS LAN Services program group in WIN-OS/2 
and creates the program icons for DOS LAN Services and DOS LAN 
Services Help. 

2. If you install the DOS LAN Services Windows drivers and Windows GUI in 
a specific DOS session, you must also load VNETAPI.SYS. This differs 
from systems running native DOS LAN Services on OS/2 LAN Requester, 
where VNETAPI.SYS should not be loaded in the same session. 

3. If you have DOS or Windows applications that require NetBIOS or 802.2, 
install the appropriate virtual device driver, using LAPS. For more 
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information, refer to the MPTS-Configuration Guide which is available 
online and resides in the LAN Services File and Print folder within the 
Information folder. 

The Windows interface provided with the DOS LAN Services Windows drivers 
does not offer all the functions of native DOS LAN Services. The following 
functions are not available from the Windows interface running with 
VNETAPI.OS2. These functions are only available if you have installed DOS LAN 
Services in a specific DOS session (on OS/2) or on a DOS workstation: 

• Logon or Logoff 

• Share directories and printers 

• Change workstation password 

• View message log 

• Change log file or device 

• Enable and disable message logging 

• WinPopup 

• Network DDE 

Refer to DOS LAN Services and Windows User's Guide, available online, for 
information about these other functions provided with DOS LAN Services. 

Connections made or deleted using the Windows interface running with 
VNETAPI.OS2 are displayed as network connections in both OS/2 and WIN-OS/2 
sessions. For example, if you make a connection to an alias from a WIN-OS/2 
session, then switch to the OS/2 command prompt and type NET USE, the new 
connection to the alias will be listed. Similarly, any connections made using the 
OS/2 LAN Requester will be reflected in your WIN-OS/2 session. This behavior 
differs from systems running native DOS LAN Services under OS/2, in which the 
connections (or disconnections) are not reflected in other OS/2 and WIN-OS/2 
sessions. 

Attention 

The DOS LAN Services Windows interface can also be used with Virtual DOS 
LAN API Support on OS/2 LAN Servers, except LAN servers configured as 
Domain Controllers. 



3.7 Connecting to Network Resources from DOS LAN Services 

DOS LAN Services enables you to use directories across the network. These 
directories, called shared directories, are used the same way that disk drives 
and directories are used on your workstation. You can use files and application 
programs on the shared directory at your workstation as though they were 
stored on your hard disk. When you use a shared directory, you establish a 
session, or connection to, that directory. You can establish connections that 
start automatically each time you log on to the network. These automatic 
connections are known as persistent connections and logon assignments. 

Persistent connections are stored locally on the workstation and can be different 
for each workstation. Each user logging on to the same workstation has the 
same connections even though their user IDs are different. Connections occur 
regardless of the type of logon, for example, local and domain. At logon, you 
are only connected to the persistent resources to which you were connected the 
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last time you were logged on. For example, if you disconnect from a drive 
resource, you are not automatically reconnected the next time you log on. 

Logon assignments are based on user IDs. They are stored on the LAN Server 
domain controller as part of the domain controller database (DCDB). They can 
be different for each user, and a user logging on to different workstations has the 
same connections. Connections occur only with a domain logon. 
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T o add a logon drive assignment, select a device and alias, then 
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T o delete a logon drive assignment, select an assignment Iron 
the list below, then select Delete. 




Logon drive assignments for your user ED: 





K: 


PEERNEOS 


M: 


DISK-CD 


P: 


PUBLIC 


T. 


DISK-TRN 


V: 


WARPSERV 



Figure 82. Changing Logon Drive Assignments 

Persistent connections and logon assignments are not mutually exclusive. You 
can have both; however, persistent connections are done first, and you may run 
into conflicts with drive and printer assignments. 

An alias is a nickname for a resource. For example, an alias of APPS can be 
created to refer to a directory on SERVER1 named C:\NETWORK\APPS. After an 
alias is assigned by a network administrator, you can refer to the directory 
simply as APPS. After an alias is assigned to a resource, you do not need to 
specify the server where the resource is located or the path to the resource. An 
alias remains defined after the domain controller is stopped and restarted. 

As an alternative, a resource can be temporarily defined by a netname. When 
combined with the name of the server on which the resource is located, the 
netname identifies a shared resource on the server. For example, a directory 
with a netname of TRANSFER on SERVER1 is referred to as: 

\\SERVER1\TRANSFER 

The combination of a server name and a netname is called a network path. 
Unlike an alias, a netname does not remain defined if the server is stopped. 
When you connect to a resource using a netname, you must specify the server 
name. 
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3.8 DOS LAN Services Logon Process 

In this section we will look in detail at the sequence of events that follow the 
execution of a logon request from a DOS client running DOS LAN Services. 

When DOS LAN Services receives a logon request the following process is 
invoked: 

1. If the user is not allowed to logon to multiple requesters with the same user 
ID (multi logon=no is specified in NETWORK.INI) and their ID and the domain 
name are both less than or equal to eight characters in length then the user 
ID/domain NetBIOS name is added to the network adapter to ensure that the 
user is not logged on elsewhere. 

Note: The format of the NetBIOS name is a eight character long user ID 
padded with blanks followed by an eight character domain name padded 
with blanks. 

2. If 1slogon=yes is specified in NETWORK.INI and either the Full or Virtual 
redirector are loaded NETWKSTASETUID2 is called to logon the user and 
validate the user ID and password. 

3. The NETUSERGETINFO API is then called to determine if the user has a 
home directory: 

• If the user has a home directory, a connection is made to it and it is 
assigned as the current drive. 

• The NETUSERGETLOGONASN API is called to get the user's logon 
assignments. 

• If an error is received that indicates that the domain control database 
(DCDB) has not been initialized: 

NETUSERDCDBINIT is called to initialize the DCDB 

NETUSERGETLOGONASN is called again 

User's logon assignments are being retrieved 

• If an error is received that indicates a downlevel server: 

A check is made to determine whether an 
\IBMLAN\DCDB\USERS\user/cf directory exists. If not a logical 
server call is made to create it. 

• Redirected I/O is then used to obtain the user's logon assignments (the 
NETSHAREGETINFO API is issued to get the server and network name of 
the alias, then an INT21H call redirects the device, filesets first, then 
printers) 

• The user logon script (PROFILE.BAT) is then executed if one exists 

• If timesync=yes is specified in NETWORK.INI the NETREMOTETOD API is 
called to get the time from the domain controller and set it locally on the 
workstation 

4. If lslogon=no is specified in NETWORK.INI or the Basic redirector is loaded 
NETWKSTASETUIDQUICKLY is called to register the user ID and password 
without validating at the server 

5. Persistent connections are connected to 

6. If the Messenger service is started then a listen NetBIOS command is issued 
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7. If the current drive is redirected then it is changed to the drive where DOS 
LAN Services is installed 

As is to be expected, the logoff process is less involved. When you log off the 
following occurs: 

1. The NETWKSTASETUID2 API is called to log the user off the domain. This 
API is also responsible for cancelling all disk and print redirection 

2. The user ID/domain NetBIOS name is then deleted 



Local Logon 

You can perform both a local logon and a domain logon. To access peer 
resources, only a local logon is necessary. If your user ID and password are the 
same both locally and on the domain, then a local logon also allows you access 
to domain resources; however, you must provide the netname 
(\\server\sharename) when making the server connection, because aliases are 
not interpreted with a local logon. In order to use aliases, you must be logged 
on to the domain. 

With only a local logon and no domain logon, you do not receive your domain 
logon assignments. However, DOS LAN Services will attempt to reconnect any 
persistent connections for that workstation. If your user ID has permission to 
use these reconnected resources, then you will be granted access. If you do not 
have permission, then the connection may be made (for example, drive LPT1 
may connect to IBM4039), but you could then not actually use the resource. 

For each user that logs on at a workstation, DOS LAN Services maintains an 
unreadable password file with the extension PWL. This file contains a local 
password, domain password (if the user has logged on to a domain), and peer 
service password (if the user has used peer resources requiring passwords). 



3.9 Sharing Requester Resources with the Peer Service 

OS/2 LAN Requester has been available with peer capabilities since OS/2 LAN 
Server Version 3.0 and has been well documented. DOS LAN Services, initially 
introduced in OS/2 LAN Server 4.0, includes a peer service which has been 
further enhanced in OS/2 Warp Server. 

The DOS LAN Services Peer service allows you to share the resources of your 
DOS workstation with other OS/2 Warp Server clients and other Server Message 
Block (SMB) based network products. 

As a server, a DOS LAN Services peer workstation with user level security has 
the following features: 

• A DOS LAN Services peer workstation can share local disks, directories and 
printer queues. 

• A DOS LAN Services peer workstation maintains it's own user account 
database and access control lists (see “User Level Security” on page 98). It 
controls access to it's local resources based on this user account database 
and access control lists. Unlike LAN Server, the peer workstation's user 
account database is not synchronized with any other user accounts 
database. 
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The user security function of DOS LAN Services provides additional NET 
commands and APIs, to administer user accounts and access control lists, 
for local and remote administration respectively. 




Figure 83. Sharing a Directory with DOS LAN Services Peer Services 

The following restrictions apply to the DOS LAN Services Peer service: 

• The following resources may not be shared by a DOS LAN Services peer 
workstation: 

- Serial devices 

- Named pipes 

— Mailslots {class 1) 

— CD-ROM drives 

• The DOS LAN Services peer workstation will only support a single 
connection at any one time. This is the single session restriction that also 
applies to the OS/2 LAN Requester Peer service. 

Full unrestricted peer capability is provided by the OS/2 Peer component of 
the OS/2 Warp Connect product. 

• The DOS LAN Services peer workstation does not support auditing or error 
logging 

• A DOS LAN Services peer workstation cannot handle logon requests 

• The following functions related to the logon process are not available at the 
DOS LAN Services peer workstation: 

— Establishment of logon assignments 

— Execution of a logon profile 

— Execution of a logon script 

— Establishment of home directory assignment 
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• The following LAN Server domain related functions are not available at a 
DOS LAN Services peer workstation: 

— Aliases for shared resources 

— Public applications 

— Remote IPL workstation support 

• A DOS LAN Services peer workstation operates as a hidden server, such that 
it does not appear visible to the NET VIEW command nor the NetServerEnum2 
API. 

• A DOS LAN Services peer workstation may not be remotely administered 
using the NET ADMIN command (you will receive a SYS0050 error and be 
informed that the network request is not valid). 

The only way to remotely administer a DOS LAN Services peer workstation 
is by issuing remote API calls (see “Peer User Level Security APIs” on 
page 101). 

• The DOS LAN Services Peer service does not support opportunistic locking 

Additional restrictions are detailed in “Peer Administration Considerations” on 
page 100. 



User Applications Drives Printers Messages Help 




'Share Detail* 
Network none: 
Device: 
Description: 



COM1 






w m 



W4B02R5GLASI 







Edit Shared Printer Detail: 



r Share Details 
Network name: 
Device: 

Decoration: 



W4602R50INK1 



[|ggyjg§J|| 



IBM 4079 Inkjet on DLS Peer 









I 











Figure 84. Sharing a Printer with DOS LAN Services Peer Services 



User Level Security 

DOS LAN Services, as included with OS/2 Warp Server, provides you with the 
ability to define access control profiles for shared resources located on the local 
workstation. Previously, the only method of defining access to shared DOS and 
Windows workstation resources was via share level security. Share level 
security allows you to specify both the password and permissions associated 
with a shared resource not the user. 
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Now user level security allows you to define access to shared resources located 
on DOS and Windows workstations at a user and group level. OS/2 Warp Server 
File and Print Sharing Services uses this form of security, which is also the 
default security mode for OS/2 peer services. 

User level security is implemented in DOS LAN Services by providing access to 
the following NET commands: 

• NET ACCESS 

Lists, adds, changes, deletes, and applies access control profiles, and also 
revokes specific permissions in access control profiles. An administrator 
can perform all actions, and a user with P permission can perform all actions 
for access control profiles except for the ADD and APPLY actions. 

Note: Access control profiles created by NET ACCESS are stored in the 

\NET\ACL.ACC file. 

• NET GROUP 

Displays the names of groups and their members, updates the group list, 
and adds and deletes groups (for administrators and users with accounts 
operator privilege). 

Note: The list of groups and their members is stored in the \NET\NET.ACC 
file. 

• NET USER 

Lists, adds, removes, and modifies user accounts in the peer workstation 
user account database. 

Notes: 

1. To make changes to the user accounts, this command must be run from 
a peer workstation. 

2. Only an administrator or user with accounts operator privilege (as 
defined in the local accounts database) can use this command. Users 
with accounts operator privilege cannot add and manage administrators 
or other users with accounts operator privilege. 

3. Peer workstations maintain a separate user accounts database locally 
that is different from the domain's user accounts database. 

4. Be careful when setting EXPIRES to a specific date. DOS LAN Services 
Peer service users cannot reset passwords once they have expired. The 
peer workstation administrator must reset the password and expiration 
date for the user. For the same reason setting PASSWORDEXP to YES is 
not recommended. 

5. The list of users is stored in the \NET\NET.ACC file. 

6. When a user is added to the peer workstation user accounts database, 
the user is automatically added to a group (USERS, ADMINS, or GUESTS, 
depending on the privilege level assigned), but if the user name has an 
associated password, that password is required for logon. Setting 
/PASSWORDREQ to NO also means that other password restrictions, 
including PASSWORDCHG, are not applied. 

7. Users with accounts operator privilege cannot create or modify 
administrator or other operator accounts. 
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8. Passwords are checked for restrictions oniy when they are changed or 
added. Therefore, when you change a password from being not required 
(PASSWORDREQ-.N) to required (PASSWORDREQ:Y), the password is not 
checked against the minimum password limitation of four characters. 

For the complete syntax of the above commands, and some examples of their 
use, please refer to the DOS LAN Services and Windows User's Guide included 
with the OS/2 Warp Server package. 

Peer Administration Considerations 

You can administer the DOS LAN Services Peer service though a command line 
interface. A graphical user interface is not provided to administer a peer 
workstation. To administer a peer workstation, you must be defined as an 
administrator in the peer workstation local user accounts database (see "User 
Level Security” on page 98). 

It is common for the owner of a peer workstation to be defined as an 
administrator on the peer workstation but defined as a user on the domain. The 
peer administrator can manage resources for only the peer workstation, but not 
the rest of the domain. 

Centrally Administering Peer Workstations 

Since the peer workstation is not part of an OS/2 Warp Server domain, it 
cannot be administered through the OS/2 Warp Server Administration 
Graphical User Interface. This makes it relatively difficult to administer 
centrally. 

This clearly illustrates the advantages of a server-based solution, provided 
with OS/2 Warp Server, over peer-to-peer networking functions provided with 
a product such as Microsoft Windows for Workgroups. 



If you decide to set up and centrally administer the peer workstations in the 
network, support will be necessary for the following responsibilities: 

• Installation of peer workstations 

• Set up of the peer workstations with printer and file sharing 

• Set up and maintenance of user accounts and group accounts for user-level 
security 

The following are other considerations you should keep in mind before setting up 
or using the DOS LAN Services Peer service: 

• You cannot remotely administer the DOS LAN Services Peer service by using 
the NET ADMIN command. You must use remote API calls to remotely 
administer the service from other workstations on the network (see “Peer 
User Level Security APIs” on page 101). 

• Aliases, applications, serial devices, mailslots and named pipes are not 
supported and cannot be shared from peer workstations. 

• The peer workstation maintains its own user account database and access 
control lists in order to control access to its resources (see “User Level 
Security” on page 98). The peer workstation's user account database and 
access control lists are not synchronized with the server domain's lists. 
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• Users and groups on the following types of requesters can access resources 
on a peer workstation if they are defined and have been granted access 
permissions: 

- DOS LAN Services 

- OS/2 LAN Requester 

- DOS LAN Requester (from LAN Server 3.0 and prior) 

- IBM PC LAN Program (PCLP) Basic 

- Microsoft LAN Manager {OS/2 and DOS) 

- Microsoft Windows for Workgroups 

- Microsoft NT 

- Microsoft Windows 95 

• A peer workstation cannot act as a logon server, since it cannot handle 
logon requests. 

• When you install the DOS LAN Services requester, the Peer service is 
automatically installed on the workstation, but is not automatically started. 
You must use the NET START PEER command, or add PEER to the autostart 
parameter in NETWORK.INI, to start the DOS LAN Services Peer service. 

• Peer workstations are hidden servers and not viewable through the NET VIEW 
command or the NetServerEnum2 API. 

— Default Peer Administration User ID and Password 

The user ID and password that you specify when you install DOS LAN 
Services is not granted administrator privileges. 

To administer your peer workstation you must first logon using a default user 
ID (USERID) and password (PASSWORD). To avoid any security exposure it 
is recommended that you then create a a new administrator user ID (or 
define the user ID that you specified at installation as an administrator) and 
delete the default. 

If you ever forget your administration user password you will have to reinstall 
DOS LAN Services. 



Peer User Level Security APIs 

The user level security feature of the DOS LAN Services Peer service provides 
the following categories of application programming interfaces (APIs) to allow a 
user with appropriate privileges to administer resources on the peer workstation, 
user accounts database and access control lists: 

• Peer workstation administration APIs, notably: 

— Share APIs 

- Session APIs 

• Protection APIs 
— Access APIs 
— User APIs 

— Group APIs 
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Differences between DOS LAN Services and OS/2 LAN Server's 
Corresponding APIs 

This section will look at the differences between the two sets of APIs and discuss 
the exceptions. 

Note: If an API category is ommitted in this section it is because the API 
functions and calling conventions are the same regardless of whether you are 
writing DOS LAN Services or OS/2 LAN Server code. 

• Access APIs 

— NetAccessEnum 

When level 1 is selected, the auditing bits (USHORT accl_attr) does not 
have any meaning because the DOS LAN Services peer workstation does 
not support the auditing function. 

• User APIs 

— Data Structure 

Some fields of data structures are not supported by the user level 
security function of DOS LAN Services which are supported by OS/2 LAN 
Server. They are as follows: 

Structure user_info_l: 



Table 6. Differences between the DOS LAN Services and OS/2 LAN Server APIs 
(Structure user_info_1 ) 


Member Name 


Difference in Comparison to OS/2 LAN Server's 
Definition 


char far*usri1_homedir 


The value must be NULL. The DOS LAN Services 
peer does not support home directories. 


USHORT usri1_flags 


The bit of UF SCRIPT(0x01, logon script bit) and 
UF_HOMEDIR_REQUIRED(0x08) must be zero. 


char far*usri1_script_path 


Must be NULL. 



Structure user info 2: 



Table 7. Differences between the DOS LAN Services and OS/2 LAN Server APIs 
(Structure user_info_2) 


Member Name 


Difference in Comparison to OS/2 LAN Server's 
Definition 


char far*usri2_parms 


Must be zero. 


long usri2Jast_logon 


A value 0 is always set. 


long usri2_last_logoff 


A value 0 is always set. 


ULONG usri2_max_storage 


DOS LAN Services ignores this field. A value of 
-1 is returned. 


USHORT usri2_units_per_week 


DOS LAN Services ignores this field. 


UCHAR far^usrtejogonjiours 


Must be NULL. 


USHORT usri2_bad_pw_count 


The value Oxffff is always returned 


USHORT usri2_num_!ogons 


The value Oxffff is always returned 


char far*usri2_logon_server 


Must be NULL. 



— NetUserSetlnfo 
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The valid parmnum values are: 



Table 8. Differences between the DOS LAN Services and OS/2 LAN Server APIs 
(PARMNUM) 


parmnum Symbol 


Corresponding Field Name 


PARM N U M_PASSWD 


usri2_passwd 


PARMNUM.PRIV 


usri2_priv 


PARM NUM_COMM ENT 


usri2_comment 


PARMNUM_USER_FLAGS 


usri2_flags 


PARM N U M_AUTH_FLAGS 


usri2_auth_flags 


PARM N U M_FU LL_N AM E 


usri2_full_name 


PARM N U M_US R_COM M ENT 


usri2_usr_comment 


PARMNUM_ACCT_EXPIRES 


usri2_acct_expires 


PARM NU M_COU NTRY_CODE 


usri2_country_code 


PARM N U M_CODE_PAG E 


usri2_code_page 


0 


all user_info_2 structure 



— Group APIs 

The user level security function of DOS LAN Services has the following 
three built in groups which may not be edited by APIs. 



Table 9. DOS LAN Services Built In Groups 


Group Name 


Member 


admin 


All accounts with USER_PRIV_ADMIN 


user 


All accounts with USER_PRIV_USER 


guest 


All accounts with USER_PRIV_GUEST 



3.10 Performance Tuning 

The default installation parameter values have been selected to provide the 
optimum performance/memory utilization ratio. The DOS LAN Services autocache 
parameter, when set to yes automatically allocates the values of numbigbuf, 
sizbigbuf and extraheap based on the amount of XMS memory available. 
However, if a performance problem is identified then you may set autocache to no 
and manually adjust the values of the following parameters: 

Work Buffers are used to construct SMBs prior to their delivery to the server. 
The sizworkbuf parameter specifies the size of work buffers; however, this 
value rarely needs to be changed because small data read requests are 
processed via the cache provided with big buffers. 

Big Buffers are used, as with previous versions of requesters, to process 
large file transfers. However, with DOS LAN Services, they are now also 
used for file caching which provides an obvious performance advantage. 
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Notes: 

1. Setting autocache to yes consumes 10KB of conventional memory. 

2. The autocache parameter is not applicable if you are using the virtual 
redirector. The virtual redirector uses 1/8 of free XMS memory for buffer 
allocation. 



3.11 DOS LAN Services Module Descriptions 

The following table outlines the function of each individual DOS LAN Services 
module. 



Table 10 (Page 


1 of 2). DOS LAN Services Module Descriptions 


Module 


Function 


DOSNET.LIB 


LAN Server APIs for DOS Applications 


INSTALL. BAT 


Installation batch file 


INSTAL16.EXE 


Protected mode installation program 


INSTALR.EXE 


Real mode installation program 


INSTALL. MSG 


Installation error/warning messages 


NETWORK.INF 


Used by installation program to configure network adapters 


NETWORK.INI 


Contains the default parameters used by NET START and other 
services 


NET. EXE 


Contains the following services: 

• Start code, for example NET START service name 

• Redirector 

• NetBEUI 

• Loader 

• Spawns CMDS.EXE (command line interface (CLI)) 

• Spawns CMDS16.EXE (protect mode CLI) 


NET.MSG 


Contains error/warning messages used by all interfaces, all 
numbers up to three digits are prefixed with 'Error', such as 'Error 
123', and all four digit numbers are prefixed with 'NET', such as 
'NET1234' 


NETH.MSG 


Cause/action descriptions for error/warning messages in NET.MSG; 
message numbers between 'NET1' and 'NET7450' 


CMDS.EXE 


Command line interface; spawned by NET.EXE 


CMDS16.EXE 


Protect mode command line interface; spawned by NET.EXE 


DLS HELP. SYS 


Redirector helper module. Hooks interrupts and passes requests on 
to the redirector 


PEER.EXE 


Peer service module; provides local file and print sharing 
capabilities 


PO.SPL 


Print queue management file used by Peer service 


PO.SEP 


Separator page used by Peer service for shared printers 


NETGUI.BAT 


Starts the DOS graphical user interface and reloads it after running 
an application 


DZG4.EXE 


Actual DOS graphical user interface executable 


SUPPORT.DAT 


Contains all DOS graphical user interface panels for both graphics 
and text modes 
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Table 10 (Page 2 of 2). DOS LAN Services Module Descriptions 


Module 


Function 


GUI. MSG 


Error/warning messages used by DOS graphical user interface and 
WDLS.EXE (Windows GUI); message numbers between NET7450 and 
NET7600 


GUIH.MSG 


Cause/action text for error messages in GUI. MSG 


MOUSE.DLL 


DLL used by DOS graphical user interface for protected mode 
mouse support 


CONNECT.DAT 


Stores persistent connection information (see 3.7, “Connecting to 
Network Resources from DOS LAN Services" on page 93) 


userid. PWL 


Password list file for a particular user ID; stores passwords for 
connections and logon 


NETPOPUP.EXE 


Provides message popup 


MESSENGR.EXE 


Receives messages and either logs them or passes them on to 
NETPOPUP.EXE 




Default message log file 


CONNECT.TXT 


DOS LAN Services troubleshooting document 


WDLS.EXE 


DOS LAN Services Windows interface 


DLSNET.DRV 


DLL used by WDLS.EXE (do not be confused by the extension) 


DLSNET.HLP 


DOS LAN Services Windows help file 


NETAPI.DLL 


LAN Server APIs for Windows applications 


PMSPLDLL 


LAN Server print APIs for Windows applications 


RUNLSAPP.EXE 


Invokes WinExec() function to run applications 


WINDLS.DLL 


DLL used by WDLS.EXE, DLSNET.DRV and RUNLSAPP.EXE 


WINPOPUP.EXE 


Interacts with NETPOPUP.EXE to display messages in a Windows 
environment 


DLSSETUP.EXE 


Modifies WIN. INI and SYSTEM.INI files to provide Windows support 
by pointing to DLSNET.DRV (see “Installation" on page 82) 


FMSHARE.DLL 


Hooks into Windows File Manager for directory sharing when the 
DOS LAN Services Peer service is active 


VNETBIOS.386 


Real mode to protect mode NetBIOS layer used by the virtual 
redirector (VREDIR.386) 


VNETSUP.386 


Virtual redirector support module used for reading .INI information 
and initialization of the redirector 


VREDIR.386 


Virtual redirector used in Windows enhanced mode 



3.12 DOS LAN Services Common Configuration Scenarios 

In the previous sections we have discussed DOS LAN Services in an IBM 
NetBEUI environment. This is the default protocol driver automatically set by the 
installation program. This protocol is faster than 802.2 but uses more memory. 
All redirectors can be used with this option. 

In this section we will look at some of the various scenarios covering the wide 
range of connectivity options provided with DOS LAN Services. 



As shipped with OS/2 LAN Server 4.0, DOS LAN Services TCP/IP support was 
provided by packaging a TCP/IP 2.1.1 for DOS Stack Kit with the product. You 
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needed to install DOS LAN Services and then install the TCP/IP Stack Kit. DOS 
LAN Services provided with OS/2 Warp Server now includes an integrated 
TCP/IP stack which is selectable when you install DOS LAN Services and choose 
to change the default protocol driver from the default IBM NetBEUI. When you 
do this you are presented with the following options: 

• Other Protocol 

• 802.2 Support 

• TCPBEUI (Real-Mode) 

• TCPBEUI (Real-Mode) and IBM NetBEUI 

• TCPBEUI (Windows Protect-Mode) 

• TCPBEUI (Windows Protect-Mode) and IBM NetBEUI 

• IBM NetBEUI 

In the following sections we will discuss the reasons for selecting each of the 
different protocols. 



Other Protocol 

If you have diskettes from another source (such as the manufacturer of the 
adapter) you would select this option if you have an OEM protocol driver. 

802.2 LAN Transport 

Loads the LAN Support Program drivers for 802.2. This protocol uses less 
memory, but runs slower than NetBEUI. 802.2 support must be installed on DOS 
workstations using remote IPL. This protocol contains LAN Support Program 
code, which makes it possible to install the LAN Support Program separately. 

All redirectors can be used with this option. 

TCPBEUI (Real-Mode) LAN Transport 

Provides NetBIOS over TCP/IP (see 6.2, “NetBIOS over TCP/IP on OS/2 Warp 
Server” on page 260 for a definition). The real-mode drivers reside under the 
real memory (first 640K). You require File and Print Sharing Services with 
TCPBEUI on the server. This protocol can be used for environments that require 
TCP/IP only. All redirectors can be used with this option. 

TCPBEUI (Real-Mode) and IBM NetBEUI 

This option provides two protocols. It provides TCP/IP and Networking 
capabilities. Depending on your constraints, you might not be able to run 
netpopup or peer servers, and then start Windows. If you have Windows for 
Workgroups installed, use TCPBEUI (Windows Protect-mode) and IBM NetBEUI. 
All redirectors can be used with this option. 

By default, this option assigns NetBEUI to LAN adapter 0. The messenger, 
netpopup, and peer servers can only use adapter 0, therefore, they will only be 
able to communicate with the other workstations running NetBEUI. To enable 
these servers to talk to workstations running TCPBEUI, you must configure 
TCPBEUI for adapter 0. 
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TCPBEUI (Windows Protect-Mode) LAN Transport 

This option can only be used with Windows for Workgroups. It provides TCP/IP 
over NetBIOS without using real memory (first 640K). To use messaging, 
netpopup (or Winpopup), and peer services (these services are started using the 
command line interface), use TCPBEUI (Windows Protect-mode) and IBM 
NetBEUI. You need to use virtual redirector with this option. 

TCPBEUI (Windows Protect-Mode) and IBM NetBEUI 

This option requires Windows for Workgroups and provides two protocols. All 
redirectors can be used with this option. 

By default, this option assigns NetBEUI to LAN adapter 0. The messenger, 
netpopup, and peer servers can only use adapter 0, therefore, they can only 
communicate with other workstations running NetBEUI. To enable these servers 
to talk to workstations running TCPBEUI, you must configure TCPBEUI for 
adapter 0. 

TCPBEUI Configuration 

If you selected a TCPBEUI protocol driver, you will be prompted for the following 
TCP/IP configuration information: 

• IP Address 

• Net subnet mask 

• Gateway address 

• Domain Name server address 

If you choose TCPBEUI support, IP address and Net subnet mask address are 
needed to start DOS LAN Services after installation. For a definition of the 
above parameters you should refer to 5.2, “Installing TCP/IP Services” on 
page 171. 

DOS LAN Services TCPBEUI Utilities 

If you have chosen TCPBEUI support the following tools are provided to assist 
you in determining the source of communication problems and creating a local 
name cache. 

Using the Ping Program 

If you are going to send a file to another host, you can ping a host to see if it is 
connected to the network. In another case, if you try to connect to a gopher 
server and you get no response, try to ping the gopher server. The Ping 
program can be used to test your connections throughout the network if you are 
having trouble communicating with another host. A host might not respond to a 
ping, however, for the following reasons: 

• A host might be inoperative. 

• A gateway between you and the host might be inoperative. 

• The host might be slow to respond. 

• The data length might be too large for the host to receive. 

• You are using a TCP/IP protocol stack not provided with this product. 

Try using additional pings to communicate with other hosts in the network. To 
determine the location of the failure, you need to know the topology of the 
network. 
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You should issue pings in the following order, until the failure is located: 

1. Send a ping to your local host. 

2. Send a ping to a host on your local network. 

3. Send a ping to each intermediate node that leads from your local host to the 
remote host, starting with the node closest to your local host. 

The ping program might not run correctly if you are using a TCP/IP protocol 
stack provided by another vendor. The ping program uses raw socket calls and 
therefore is tied to the stacks provided by IBM. 

The format of the PING command is: 

ping [-1 datalen] [-n count] hostname 
ping hostname [-1 datalen] [-n count] 

where: 

-1 datalen Is the size of the ICMP data to send 

-n count Is the number of the ICMP requests to send 

hostname Is the remote name or dotted decimal IP address 

You may also use the Windows ping program, which you will find in the TCP/IP 
program group. For full details refer to Network Administrator's Reference 
Volume 1: Planning, Installation, and Configuration. 

Using the NBUTIL Program 

Installing DOS LAN Services to run on TCPBEUI allows your computer to 
communicate with other computers that are also running TCPBEUI. TCPBEUI is 
an implementation of the Network Basic Input/Output System (NetBIOS), which is 
designed to operate with TCP/IP. This implementation adheres to the RFC 
1001/1002 specification, allowing users to run NetBIOS applications over their 
TCP/IP networks. Both the client and the server must be running NetBIOS over 
TCP/IP to communicate. 

When using TCPBEUI to communicate to other workstations across multiple 
subnets, you must use the NBUTIL.EXE utility. NBUTIL creates a local name 
cache on your workstation. NBUTIL associates IP addresses with NetBIOS 
names and stores this information so TCPBEUI can locate other workstations 
across subnets. 

The NBUTIL program is accessed by using the DOS command NBUTIL with a 
variety of options that allow you to perform the following tasks: 

• Add a NetBIOS name/I P address pair to the NetBIOS name table. 

• Delete all entries from the NetBIOS name table. 

• Display all the current entries in the NetBIOS name table. 

The NBUTIL command must be executed after the TCP/IP protocol driver is 
running. Therefore, if you are using Windows for Workgroups, in which case the 
TCPPro VxD protocol driver will have been installed, you must run the NBUTIL 
command from a DOS prompt only. 
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Note: If you exit Windows, the protocol driver will be terminated and the 
NetBIOS name table is no longer in memory. You must re-enter the NBUTIL 
command after starting Windows. 

If you are running Windows with DLS and you installed the TCPPro Real-mode 
Driver, you can also enter the NBUTIL command manually at the DOS prompt. 

Note: If you restart your PC after specifying the command, the NetBIOS name 
table is no longer in memory and you must re-enter the command after 
restarting your PC. 

If you want to run the command automatically each time your PC is started, 
enter the command in the AUTOEXEC.BAT file following the commands 
associated with loading the TCP Pro real mode protocol driver. 

You can add the NBUTIL command to add entries to the NetBIOS name table in 
two different ways: 

• By adding the IP address of each system you want to access with its 
associated NetBIOS name individually. 

• By creating an ASCII text file containing a number of IP addresses with their 
associated names. All of these names can be added to the NetBIOS name 
table by invoking the NBUTIL command only once. 

The following example demonstrates how to use NBUTIL to store information on 
a domain controller: 

nbutil -a 129.35.15.136 tdomain -w 
nbutil -a 129.35.15.136 tserver -x 

where tdomain is the name of the domain and tserver is the name of the server. 

NBUTIL Command Examples: The following command adds the NetBIOS name 
MailServer with the IP address 111.111.11.11 to the NetBIOS name table. (The 
LAN adapter number used by the TCP Pro protocol driver is 2.) 

NBUTIL -a 111.111.11.11 MailServer -1 2 

The following command clears the NetBIOS name table. (The LAN adapter 
number used by the TCPPro protocol driver is 2.) 

NBUTIL -c -1 2 

The following command translates the NetBIOS name FileServer into names that 
can be used by servers running LAN Manager and adds them to the NetBIOS 
name table. The IP address of FileServer is 111.111.11.11. The LAN adapter 
number used by the TCP Pro protocol driver is 1. 

NBUTIL -a 111.111.11.11 FileServer -x -1 1 

The following command adds the entries in the ASCII text file called NAMES1 to 
the NetBIOS name table and translates the NetBIOS names into names that can 
be used by servers running LAN Manager. The LAN adapter number used by 
the TCP Pro protocol driver is 0, therefore, the -1 option is not required. 

NBUTIL -f NAMES -x 

Note: If you are using TCP Pro for both LAN and remote access, there are two 
protocol drivers active. If you intend to use NetBIOS applications for both 
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connections, you must identify the LAN adapter number for each driver in 
separate NBUTIL commands. 

For details of the syntax of the NBUTIL command please refer to Network 
Administrator's Reference Volume 1: Planning, Installation, and Configuration. 



3.13 NETWORK.INI Configuration File Parameters 

When DOS LAN Services is started using the NET START command, the 
parameters in the NETWORK.INI file are read and used to setup the behaviour of 
the DOS and Windows clients. A NETWORK.INI file was created because DOS 
truncates any commands that are more than 127 characters long; therefore it is 
not possible to pass all of the parameters to the NET START command. 

The NETWORK.INI file resides in the directory where you installed DOS LAN 
Services. NETWORK.INI has the following main sections: 

• Network 

• Messenger 

• Netpopup 

• Peer 

Note: There are also other sections that may appear in the NETWORK.INI as 
you configure your environment, such as Password Lists, Local Applications, and 
Network Applications. 

You can change the NETWORK.INI file manually or by using the DOS LAN 
Services Setup program. The following tables provide information on 
parameters in the Network, Messenger, Netpopup and Peer sections. 

NETWORK.INI Network Parameters 

The following table provides details of the parameters in the [network] section of 
NETWORK.INI. 

Note: All of the following parameters are valid for the virtual redirector except 
for autocache. 



Table 11 ( Page 1 of 3). NETWORK. INI Network Section Parameter Values 


Parameter 


Description 


Valid Values 


Default 

Value 


computername 


Identifies the workstation to the 
network 


Up to 15 alphanumeric 
characters or special 
characters including ! # 
$ % & ( ) 0 . { ) a ' ~ 


Name 

specified 

at 

installation 


lanroot 


Directory where DOS LAN 
Services is installed and starts 


Fully qualified path 
(drive letter and path) 


C:\NET 


autologon 


Prompts user to logon to a 
domain when DOS LAN 
Services starts 


Yes, No 


Yes 


autostart 


Indicates which services to 
start when NET START is entered 


netbeui, basic, full, 
predir, messenger, 
netpopup, peer 


Basic 


guiconfig 


Specifies color scheme to be 
used in DOS GUI 




0,0,1 
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Table 11 (Page 2 of 3). NETWORK.INI Network Section Parameter Values 



Parameter 


Description 


Valid Values 


Default 

Value 


username 


Identifies the user to the 
network 


Up to 20 alphanumeric 
characters or special 
characters including I # 

$ % & ( ) 0 _ { } A ' ~ 


Name 

specified 

at 

installation 


domain 


Name of the domain that the 
workstation belongs to 


Up to 15 alphanumeric 
characters or special 
characters including I # 
$ % & ( ) 0 _ { } a ' ~ 


Name 

specified 

at 

installation 


reconnect 4 


Specifies whether persistent 
connections are reconnected 
when logging on 


Yes, No 


Yes 


lslogon 


Specifies whether logon 
verification is to be performed 
by the domain controller 


Yes, No 


No 


numbigbuf 1 , 2 


Specifies the number of big 
buffers to use (Full and Virtual 
redirectors only) 


0 to 4096 


2 


sizebigbuf 1 , 2 


Specifies the size of big buffers 
in KB (Full and Virtual 
redirectors only) 


4096 to 32768 


4096 


nwnworkbuf 1 


Specifies the number of work 
buffers to use 


2 to 16 


2 


sizworkbuf 1 


Specifies the size of work 
buffers to use in KB 


512 to 16384 


1024 


extraheap 1 , 2 


Allocates extra heap space for 
the redirector, and should be 
tuned for file-intensive 
applications, such as databases 


1024 to 32768 


0 


keepcon 


Specifies the time to keep 
dormant connections 


0 to 65000 


60 


sesstimeout 


Specifies the time to keep 
dormant sessions 


10 to 30000 


90 


autocache 1 


Automatically allocates 
numbigbuf, sizbigbuf, and 
extraheap based on the amount 
of XMS memory available, 
overriding the individual values 
set for these parameters, and 
is recommended to increase 
performance 


Yes, No 


Yes 


printbuftime 1 


Specifies the amount of time, in 
seconds, before a print job is 
sent to the server after the 
print job is submitted 


0 to 65535 


0 


lanas 1 


Specifies the number of LAN 
adapter cards used by the 
workstation 


0 to 7 


1 


ripl 


Identifies a remote IPL 
workstation 


Yes, No 


NO 


passwordcaching 


Indicates that passwords are to 
be cached to a file and saves 
passwords to servers in a 
password protected file so the 
user does not have to enter a 
password for each server that 
they access 


Yes, No 


Yes 
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Table 11 (Page 3 of 3). NETWORK .INI Network Section Parameter Values 


Parameter 


Description 


Valid Values 


Default 

Value 


multi logon 5 


Indicates whether the user ID 
can be logged on at multiple 
workstations 


Yes, No 


Yes 


securelogon 6 


Prevents local logon, if the user 
ID cannot be validated on the 
domain 


Yes, No 


No 


browseal ias 1 , 3 


Defines whether netnames or 
aliases are displayed when 
using the Browse option in a 
Windows environment 


Yes, No 


Yes 


timesync 7 


Specifies whether or not the 
time on the local machine 
should be synchronized with 
the time at the domain 
controller at logon 


Yes, No 


Yes 


biglie 


Determines whether to lie 
about drives greater than 2GB 
(DOS does not support drives | 
greater that 2GB: therefore it 
must lie if disks are greater 
than 2 GB) 


Yes, No 


Yes 


mailslots® 


Use mailslots 


Yes, No 


Yes 


numdgrambuf® 


Number of datagram buffers to 
be allocated 


Oto 16 


3 


sbinterval® 


Interval of time between 
sideband timeouts 


0 to 65535 


120 


sbtimeout 8 


Time before timing out a 
sideband request 


0 to 65535 


3 


sbcount® 


Count before disabling 
sideband 


0 to 65535 


5 


Notes: 

1. This parameter must be manually added to the NETWORK.INI file to change the default. The 
installation program does not add this parameter to the NETWORK.INI file. 

2. This parameter is overridden by autocache=yes. 

3. Browsing for aliases is valid only on LAN Server domains. If this parameter is set to Yes, 
aliases are browsed. If no aliases exist on the domain, netnames are browsed 
automatically. If this parameter is set to No, browsing for aliases is not attempted. 

4. While logon assignments are reestablished whenever you log on to the domain on which 
they exist, additional connections that you made to shared directories or printers, known as 
persistent connections, are also reestablished providing that you log on at the same 
workstation. 

5. This parameter is valid only when both the user ID and the domain are 8 bytes or less in 
length. 

6. This parameter is ignored if LSLOGON = NO. 

7. If this parameter is not specified, DOS LAN Services synchronizes the time on the local 
machine with the time at the domain controller at logon. The length of time that it takes to 
log on will be reduced if timesync=no is added to the [network] section of NETWORK.INI: 
however, the time at the local machine will not be synchronized with the domain controller. 

8. Not valid for the Basic redirector. 
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NETWORK.INI Messenger Parameters 

The following table provides information on the parameters in the [messenger] 
section of NETWORK.INI. 



Table 12. NETWORK.INI Messenger Section Parameter Values 


Parameter 


Description 


Valid Values 


Default Value 


logfile 


The name of the file 
where received 
messages are logged 


Alphanumeric 
characters. See the 
DOS user's guide for 
valid characters that 
may be used when 
creating a file 


MESSAGES.LOG 


sizemembuf 


Specifies the size of the 
message buffer to use 
in KB 


512 to 40S6 


512 


nummsgnames 


Specifies the number of 
message names to be 
added to the 
workstation 


2 to 8 


2 



NETWORK.INI Netpopup Parameter 

The following table provides information on the [netpopup] section of 
NETWORK.INI. 



Table 13. NETWORK.INI Netpopup Section Parameter Values 


Parameter 


Description 


Valid Values 


Default 

Value 


msgtimeout 


Defines the length of time, in 
seconds, that a message is 
displayed if Esc is not pressed, 
if the value is set to -1, a 
message is displayed until Esc 
is pressed. 


-1 to 1800 


60 



NETWORK.INI Peer Parameters 

The following table provides information on the [Peer] section of NETWORK.INI. 

Attention 

Whilst the following represents a complete list of parameters, certain 
parameters have been included which may not currently be relevant. In 
particular, parameters that imply multiple concurrent client connectivity to 
peer workstations are not implemented in this release of DOS LAN Services. 



Table 14 (Page 1 of 3). NETWORK.INI Peer Section Parameter Values 


Parameter 


Description 


Valid Values 


Default 

Value 


A20Moniter 


Saves the state of the A20 line 
during task switching, some 
memory managers fail when 
set to 1, if your system hangs 
and are using a memory 
manager this should be set to 0 


0, 1 


1 
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Table 14 (Page 2 of 3). NETWORK. INI Peer Section Parameter Values 




Parameter 


Description 


Valid Values 


Default 

Value 


NumRDRs 


Specifies the number of 
workstations that can connect 
to resources on your 
workstation at one time 


3 to 251 


10 


NumShares 


Specifies the number of 
resources that may be shared 
on the peer workstation 


2 to 256 


10 


NumReqBuf 


Indicates the number of buffers 
the Peer will use to receive 
requests from clients and send 
responses to clients. 


2 to 127 


8 


SizeReqBuf 


Indicates the size (in bytes) of 
the buffer the peer uses to 
receive requests from clients 
and send responses to clients. 
This is an alias of XmitSize. 


512 to 3276 


4096 


XmitSize 


Specifies the size (in bytes) of 
the transmit buffers the Peer 
will use when transferring data 
(NumReqBuf * XmitSize < 
48KB) 


512 to 32768 

j 


2048 


MaxShares 

i 


Indicates the maximum number 
of resources that may be 
shared on the peer 
workstation. This is an alias of 
numshares. 


2 to 256 


10 


MaxConnections 


Indicates the maximum number 
of connections clients can have 
to the peer workstation. 


2 to 500 


128 


MaxCmds 


Indicates the maximum number 
of NCBs (Network Control 
Blocks) that the peer can use. 


4 to 255 


12 


MaxTx 


Indicates the maximum number 
of rerequests that a peer 
workstation may process at 
one time. 


1 to 8 


4 


Interval 


Indicates the maximum period 
(in 50 millisecond units), from 
when the peer yields control, 
until the peer at background is 
awakened. 


20 or greater 


20 


TaskTimeSlice 


Specifies the amount of time 
(ticks) the 

foreground/background will 
each run. (Timeslice=FB) 


00 to 99 


54 

1 



Value 

0 

1 

2 

3 

4 

5 

6 
7 
6 
9 



Ticks 

2 

4 

6 

10 

14 

22 

30 

42 

56 

72 
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Table 14 (Page 3 of 3). NETWORK.INI Peer Section Parameter Values 

Parameter Description Valid Values Default 

Value 

OpenHode Indicates the mode in which 0 to 3 3 

files will be opened when an 
open request is received 

0 = Use Open mode that 
application requests 

1 = DENY-NONE sharing 
mode if read-only access to 
.EXE or .COM files. 

COMPATIBILITY-MODE for 
.BAT files or if write access 
to .EXE or .COM files. 

2 = DENY-NONE sharing 
mode if read-only access to 
.EXE or .COM files. 

DENY-WRITE sharing mode 
if read-only access to .BAT 
files. 

COMPATIBILITY-MODE if 
write access to .EXE, .COM 
or .BAT files. 

3 = DENY-NONE sharing 
mode on all compatibility 
mode opens 

FileShareSize Specifies the number of bytes 512 to 32768 2048 

allocated for the DOS storage 
area used to record file sharing 
information, (If SHARE.EXE is 
started before the Peer, the 
values that were specified 
when SHAREEXE was started 
will be used) 

Share Locks Specifies the maximum number 20 to 1000 20 

of active locked ranges in files 

that you can share with the 
Peer service, (If SHARE. EXE is 
started before the Peer, the 
values that were specified 
when SHARE.EXE was started 
will be used) 

FMShare 1 Indicates whether you want to Yes, No Yes 

be able to share directories 
from the Windows file manager 

Spool Dir 1 Indicates where you want your Any local drive and C:\NET 

spool files to be stored, this directory 

allows you to store your spool 
files somewhere other than the 
DOS LAN Services program 
directory, RIPL machines need 
to have this parameter to share 
printers when using the Peer 
service 

Notes: 

1. This parameter must be manually added to the NETWORK.INI file to change the default. The 
installation program does not add this parameter to the NETWORK.INI file. 



Chapter 3. File and Print Clients 115 




























Sample NETWORK.INI File 

The following is a sample NETWORK.INI file. 



[network] 

guiconfig-1,0,1 

computername=W4602R10 

lanroot=C:\NET 

autostart-netbeui predir peer messenger netpopup 

username n A948Rl 

domain-ITSCAUS 

lslogon-yes 

reconnect-no 

passwordcach i ng=yes 

timesync-no 

multilogon=no 

[Messenger] 

sizemembuf-1024 

[netpopup] 

msgtimeout-15 

[install] 
peer=yes 
gui=yes 
windows-yes 
protocol -netbeui 

[Password Lists] 

USERID»C: \NET\USERID. PWL 
A948R1-C: \NET\A948R1 . PWL 

[peer] 

fmshare-yes 



Figure 85. Sample DOS LAN Services NETWORK. INI File 



3.14 Password Coordination 

The Network SignON Coordinator Client provides the end user a way to perform 
a signon/signoff operation. The Client can operate on either an OS/2 or DOS 
platform and manage passwords and logons in: 

• OS/2 Warp Server Domains 

• NetWare Servers 

• Hosts 

• Local facilities 

These operations are specified in a user configured ASCII file (NSC.INI) which 
contains the location definitions which may contain a user ID to be used for 
request processing. The same location can be defined as many times as is 
necessary to include all the user IDs that you have at that location. 

Network SignON Coordinator will prompt you for your current password and user 
ID (if not already specified in NSC.INI) which is then combined with location 
information to process your request (as shown in Figure 86 on page 117). 



116 Inside OS/2 Warp Server, Volume 1 






Figure 86. Network SigrtON Coordinator - Signon Window 

Options that can be used in NSC are: 

• Use a different user ID than the one the end user inputs. 

• Specify that the user is to be logged on to a specific domain. 

• Specify an Exit Routine to be executed after Network SignON Coordinator 
performs the signon/signoff operation. Network SignON Coordinator allows a 
user to signoff all locations with a single command. 

• Change password across ail defined domains in one operation. If the user 
selects the option to change passwords, the user is prompted to enter and 
confirm the new password as Figure 87 illustrates. The password change is 
then initiated at all locations defined in their Network SignON Coordinator 
configuration file. 



Change Passwur d - ' AS 48 R1 



Typeypur Current Password and New Password, 
Seleci tIK to change your password, 

ChagePasswcard — — * — - — ^ . 

Current Password: fSST _ j | 

j {KaaraarBia? j| 

T|g»e tie New;Password . , . j -v-i 

.regain, for confirmation; p 



Note: Passwords wlU notdisplay. 



Figure 87. Network SignON Coordinator - Change Password Window 

Network SignON Coordinator provides additional functions and options to allow 
users to tailor the system to fit their needs. These functions and options include: 

• Queueing requests to LAN Server domain controllers when they are not 
available. 
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• The ability to specify different user IDs on each system while using the same 
signon password on every system. 

• An OS/2 API and toolkit that supports all of the functions of Network SignON 
Coordinator while bypassing the user interface. 

• User Exits for additional coordination or synchronization of signons, changing 
passwords and signoffs. 

• Configuration options for user ID character set, minimum/maximum user ID 
length, and minimum/maximum password length. 

To summarize, Network SignON Coordinator is a tool for end users who, by 
entering their user ID and password once at a menu, have their signon requests 
processed at any number of OS/2 Warp Server domain controllers. 

Note: Users in a double-byte character set (DBCS) environment are limited to 
using single-byte characters in their user IDs and passwords. 



Security Considerations 

Network SignON Coordinator is not a security product; it is a productivity aid. 
However, since it does help the user manage passwords, some care has been 
taken to avoid creating additional security exposures for the user. 

Attention 

Review the following with respect to your security requirements. If any of 
these possible exposures is unacceptable, you should not use Network 
SignON Coordinator. 



• Network SignON Coordinator assumes the user has the same password at 
all locations. If a user's password is compromised, the security exposure 
may be greater since all locations can be accessed with that password. 

• Network SignON Coordinator can remember the user's password once it has 
been entered, but only if the SAVEPW option is configured. The default 
operation requires the user to reenter the password each time it is required. 

The password is always discarded when Network SignON Coordinator is 
terminated, even if SAVEPW is configured. 

• Network SignON Coordinator does not keep passwords in the clear in 
memory except when necessary to call external application programming 
interfaces. The password is masked and distributed using a simple 
reversible algorithm designed to prevent casual viewing of the password. 

• Network SignON Coordinator does not send passwords from Network SignON 
Coordinator Clients to Network SignON Coordinator Servers in the clear. 

The password is masked to prevent casual viewing of the password via 
network analyzers. 

• Products supported by Network SignON Coordinator send the passwords 
across the network using different techniques. For information on how 
passwords are communicated by these products, consult the product 
information for that product. 

• Network SignON Coordinator provides no function for restricting access to 
locations. Access to other locations is controlled by each location's own 
security facility. 
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Network SignON Coordinator performs no encryption, and is therefore not 
subject to any export restriction related to encryption. 



Installation 

OS/2 Warp Server installs the OS/2 Client and Server part of Network SignON 
Coordinator. This allows a workstation to function as both a Network SignON 
Coordinator OS/2 Client and a Network SignON Coordinator Server. 



Configuration 

All configuration information for Network SignON Coordinator itself is stored in a 
flat ASCII file called NSC.INI. An ASCII file editor can be used to modify the file 
to customize the configuration. The NSC.INI file comes with the defaults for 
menu interaction. Configurable entries include: 

• Minimum and maximum user ID 

• Password lengths 

• Sound 

• Menu shortcut 

• Default user ID 

The NSC.INI file does not come with any pre-configured LAN Domain Server or 
Host names. Entries for each LAN Server and host must be added. The default 
NSC.INI file for an OS/2 client only contains the following line: 

LOCAL, ON 

The NSC.INI file may be replicated to multiple directories to allow support of 
different users or different system views. A copy of the file must either reside in 
the current directory or in a directory specified in the DPATH when executing NSC, 
NSCRSON, NSCRSOFF or calling the NSCRSIGN API. 

The NSC.INI file may be modified by any ASCII file editor (for example, the OS/2 
Enhanced Editor). Each line defines a configuration option or operation. Any 
line beginning with an asterisk is considered to be a comment and is ignored. 
Any text following the first blank (space) character on a line is considered to be 
comment text and is ignored. Although options are all shown in upper case, 
they may be entered in upper, lower or mixed case. 

An example of a configuration file is shown in Figure 88. 



USERID=A948R1 

EX I T , I D=1 , NAME=D : \NSC\PEERPASS . CMD 
LOCAL, ON, EXITID=1 
LANSERVER, IBM , NAME=W4602S01 , ON 
LANSERVER, NOVELL, NAME=NW312 , USERID=NWUSER 



Figure 88. OS/2 Client NSC.INI File Example 
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©ECHO OFF 

rem %1 = 0 for signon, 1 for signoff, 2 for change password, 

rem %2 = Configuration definition index 

rem %3 = Return code 

rem %4 = User ID 

rem %5 = Current Password 

rem %6 = New Password 

rem 

rem exit if not a change password request 
IF NOT %1 == 2 GOTO END 

rem repeat the NET PASSWORD line with the name of all the peers that 
rem you want to change your password on 
NET PASSWORD \\W4602R01 %4 %5 %6 
NET PASSWORD \\PEERCD %4 %5 %6 
: END 

Figure 89. NSC Exit for Changing Peer Passwords 

The example allows a logon to an OS/2 Warp Server domain, and defines user 
IDs on two IBM Peer for OS/2 Version 1.0 machines that are to be maintained. 
The NSC Exit PEERPASS.CMD allows passwords to be changed on peer 
workstations. 



The following table provides details of the NSC.INI options that may be set. 



Table 15 (Page : 


1 of 2). NSC. INI Configuration File Options 




Option 


Description 


Valid Range 


Default Value 


USERID 1 


Specifies the user ID to be 
used for signon operations 


Any character 
that is part of the 
user ID 
Character Set 


none 


CHARSET 2 


Specifies characters (other 
than alphanumerics) that are 
valid in user IDs and 
passwords 


Graphic ASCII 
characters, other 
than a space 


All alphanumeric 
characters plus 
the 

non-alphanumeric 
characters #, @ 
and $ 


MINUIDLEN 


Defines the minimum user ID 
length 


1 to 8 characters 


4 characters 


MAXUIDLEN 


Defines the maximum user ID 
length 


1 to 47 
characters 


8 characters 


MINPWLEN 


Defines the minimum password 
length 


1 to 8 characters 


5 characters 


MAXPWLEN 


Defines the maximum 
password length 


1 to 8 characters 


8 characters 


BEEP 


The BEEP option allows the 
user to turn on or off the beeps 
that are sounded when error 
messages are displayed or 
invalid keys are pressed 


ON, OFF 


ON 


SIGNON 3 


Causes the Signon dialog to 
immediately be displayed when 
the PM interface (NSC.EXE) is 
started 


none 


none 
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Table IS (Page 2 of 2). NSC.INI Configuration File Options 



Option 


Description 


Valid Range 


Default Value 


SAVEPW* 


Specifies that the end user's 
password should be recorded 
and used for subsequent 
password requests in this 
session 


ON, OFF 


OFF 


CONFIRMEXIT 


Defines whether a warning 
message is displayed before 
Network SignON Coordinator 
exits 


ON, OFF 


OFF 


DEBUG 3 


Specifies that additional 
information should be logged 
when a problem occurs 


none 


none 



Notes: 



1. Lower case alphabetic characters in the default user ID will be converted to upper case (see 
User ID Character Set Option). The user ID entered in the Network SignON Coordinator 
Signon menu becomes the default user ID for each system specified with a DOMAIN, HOST 
or LOCAL operations. This user ID may be overridden in any of these operations by 
specifying the USERID parameter for the operation. 

2. This option is useful when you use the UPMCSET / E command to extend the user ID 
character set. You cannot specify the alphanumeric characters A through Z, a through z, 
and 0 through 9. Only graphic ASCII characters other than a space can be specified, (they 
are 0x21..0x7E, 0x80..0xFE). Lower case extended ASCII characters should be avoided, as 
they will not be converted to upper case, and may thus not give the desired result when 
passed to U PM or LAN. You can specify up to 159 characters. This is enough to specify all 
the non-alphanumeric graphic ASCII characters. No check is made for duplicate characters. 

3. When specified the equivalent action of using the mouse to select Actions, Signon, and 
Default Systems is performed. 

4. If you select the Default Signons or Change Password actions, the previously entered 
password is used. The password is not stored on disk, but hidden and masked in memory. 
When Network SignON Coordinator is closed, the saved password is no longer available. 

5. This option should only be specified for problem determination purposes since user request 
processing is slower with this option defined. 



The following is a list of the configuration and signon operation options defined 
in the configuration file. 



Definition 

LOCAL 

NODE 

LANSERVER 

HOST 

SERVER 



To specify 

UPM Local signon 
UPM Node signon 

OS/2 Warp Server or NetWare Server logon 

Host signon 

NSC/2 Server machine 



The order of the operations is very important since Network SignON Coordinator 
executes them in order. The server definitions are also stored in the 
configuration file. Their position in the file relative to the signon operations 
determines where the signon operations are executed. 
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Using Password Coordination 

From an OS/2 Warp Server workstation, or an OS/2 or DOS client workstation, a 
user can perform: 

• Local logons - For administration of local UPM and logon to other 
applications like DB2/2 

• LAN logon - Used by OS/2 Warp Server for attaching to a domain 

• NetWare login - Used to log in to a NetWare Server 

• Peer password management - managing your passwords on OS/2 peer 
workstations 

Network SignON Coordinator uses two signon operations parameters in NSC.INI: 

• LOCAL - for local logons and password changes in the local UPM 

• LANSERVER - for one LAN (domain) logon and password changes 

LANSERVER is also used for NetWare server logins and password changes 

Password changes on OS/2 peer workstations are handled by a NSC exit 
which runs NET PASSWORD commands to change peer passwords. 

Note 

IBM Peer for OS/2 Version 1.0 (for OS/2 Warp Connect clients) workstations 
do not support logons, however it still possible to maintain client passwords 
defined in the peer server because Network SignON Coordinator can use the 
NET PASSWORD command to perform password changes which only requires 
UPM on the peer workstation. 

Network SignON Coordinator used in a pure peer environment is useful to 
synchronize passwords, not for logging on. 



LOCAL Signon Operation 

A LOCAL operation is used to make OS/2 UPM password changes and optionally 
logon to the local UPM. The syntax is: 

►► — LOCAL — [ , ON] — [,USERID=<userid>] — [,EXIT=<fi lename>] ► 

► — [,EXITID=<exitid>] 



The ON option requests Network SignON Coordinator to perform a local logon as 
well as synchronize password changes with UPM. 

If the user's account on the local workstation is under a different user ID than the 
user ID provided to Network SignON Coordinator (from the USERID configuration 
option, from the command line, from the API, or from the Signon dialog), the 
USERID = parameter may optionally be specified. Lower case alphabetic 
characters in the user ID will be converted to upper case. This parameter also 
allows a user to synchronize passwords for multiple accounts on the client 
workstation, each with a different USERID = parameter. 

If the EXIT parameter is optionally provided, Network SignON Coordinator will 
execute the specified command file or executable program for each request 
made for this Local operation. A complete path (up to 80 characters) may be 
specified if the command file or executable program is not in the PATH. 
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For example, the NSC OS/2 Client will perform a local logon for the user at 
signon and change the password on the client workstation when requested and 
execute the user command file PEERPASS.CMD after each request with the 
following operation: 

LOCAL , ON , EXI T=D : \NSC\PEERPASS . CMD 



@ECH0 OFF 

rem %1 = 0 for signon, 1 for signoff, 2 for change password, 

rem %2 = Configuration definition index 

rem %3 = Return code 

rem %4 = User ID 

rem %5 = Current Password 

rem %6 = New Password 

rem 

rem exit if not a change password request 
IF NOT HI = 2 GOTO END 

rem repeat the NET PASSWORD line with the name of all the peers that 

rem you want to change your password on 

NET PASSWORD \\W4602R01 %4 %5 %6 

NET PASSWORD \\PEERCD %4 %5 %6 

:END 



Figure 90. NSC Exit for Changing Peer Passwords 

Multiple requests for password change operations or any other operation can be 
defined within the configuration file to be executed either on the Client or at the 
Server. The EXIT parameter is required for password maintenance of peer 
workstations. Using NSC, peer workstations must have the same user ID defined 
as the user ID defined locally. 

LANSERVER Signon Operation 

A LANSERVER operation is used to make LAN Server password changes and 
optionally logon to the LAN Server. You can specify multiple LAN Server 
definitions to be processed locally, but LANSERVER definitions cannot follow a 
SERVER definition. The syntax is: 

►► — LANSERVER , ■ — [ I BM | NO V ELL] , — [ , NAME=<name>] — [ , ON] — [ , USERI D=<useri d>] — ► 
► — [,EXIT=<filename>] — [,EXITID=<exitid>] x 



The ON option requests Network SignON Coordinator to perform a logon to an 
OS/2 Warp Server Domain Controller or NetWare server as well as synchronize 
password changes. 

The value of name is the OS/2 Warp Server domain or NetWare file server's 
name. 

If the user's account on the server is under a different user ID than the user ID 
provided to Network SignON Coordinator (from the USERID configuration option, 
from the command line, from the API, or from the Signon dialog), the USERID 
parameter may optionally be specified. The user ID on a peer must be the same 
as the user ID defined locally. Lower case alphabetic characters in the user ID 
will be converted to upper case. This parameter also allows a user to 
synchronize passwords for multiple accounts on the same domain controller by 
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including multiple LANSERVER operations for the same domain controller, each 
with a different USERID parameter. 

If the EXIT parameter is provided, Network SignON Coordinator will execute the 
specified command file or executable program for each request made for this 
LANSERVER operation. For example, an exit routine could check for a 
successful domain logon and perform a NET USE for a resource controlled by the 
domain. A complete path (up to 80 characters) may be specified if the command 
file or executable program is not in the PATH. 

For example, the Network SignON Coordinator OS/2 Client will perform a LAN 
Server logon for the user on to domain W4602D01 at signon and change the 
password on domain W4602D01 when requested with the following operation: 

LANSERVER , NAME=W4602D0 1 , ON 

Note: Lower case alphabetic characters in the domain name will be converted 
to upper case. 

Note: Multiple LANSERVER operations can be specified, however they can only 
be executed from the Client. Since it is only possible to have one active domain 
logon and one active NetWare login on a workstation, only the primary domain 
and/or NetWare server should include the ON option. LANSERVER operations 
cannot follow a SERVER definition. 

Figure 91 shows the Network SignON Coordinator main folder which is accessed 
from the OS/2 System folder. 



.MSO/?: Password Coordination - Icon View > 



Password Coordination 
Password Coordination Server 
Password Retry 
Remove Password Coordination 



llii 



Figure 91. Password Coordination - Main Folder 

For more information open NSC Reference and the LAN Requester User's Guide 
online book files. 
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Chapter 4. Adapter and Protocol Services 



OS/2 Warp Server provides you with a wide range of supported networking 
protocols and communication adapters which you may use in many 
combinations to suit your requirements for a server system. Adapter and 
Protocol Services may be called the communications engine of OS/2 Warp 
Server since they provide communication support for any of the other 
components of this product. 

To go even further, Adapter and Protocol Services also provide LAN support for 
applications that you may want to install on top of OS/2 Warp Server and for 
DOS and Windows applications that you can also run under OS/2. 

This chapter will introduce Adapter and Protocol Services to you and explain 
how to install and configure it, and how to make use of the new and advanced 
features of this key component of OS/2 Warp Server. 



4.1 Overview of Adapter and Protocol Services 

In order to support the variety of network applications and services that come 
with OS/2 Warp Server, and to support many additional networking products, 
Adapter and Protocol Services provide a very complete set of networking 
protocols which can be used in a LAN environment as well as for wide area 
networking. 



New Features 

Before going into the details of Adapter and Protocol Services, we want to 
highlight the new features that are provided with OS/2 Warp Server in regard to 
networking support: 



Table 16. New Features of Adapter and Protocol Services 


System Component 


Description 


Dynamic Host Configuration 
Protocol (DHCP) client 


DHCP clients will contact DHCP servers on the 
network in order to automatically and 
dynamically obtain the addresses and 
configuration information about the network and 
about host operational parameters as specified 
by network administrators. 


Dynamic Domain Name 
Services (DDNS) client 


DDNS enhancements enable client hosts to 
dynamically register their name and address 
mappings in the DNS tables directly, rather than 
having an administrator manually perform the 
updates. 


Support for 1000 clients with 
TCPBEUI 


The NetBIOS over TCP/IP interface can now be 
activated four times which will allow for 1000 
active NetBIOS sessions that your OS/2 Warp 
Server system can support over TCP/IP at the 
same time. 



We will discuss those features in separate chapters later in Chapter 5, “TCP/IP 
Services” on page 167 and Chapter 6, “NetBIOS over TCP/IP (TCPBEUI)” on 
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page 259. In this chapter we will discuss the base MPTS functions and some 
enhancements. 

Adapter and Protocol Services can be divided into two parts, 

• Actual adapter and protocol support (LAPS) 

• Sockets multiprotocol transport services (MPTS) 



Adapter and Protocol Support (LAPS) 

Originally, LAPS was called LAN Adapter and Protocol Support, but since it now 
also includes drivers for wide area networking adapters, we skipped the word 
LAN, but kept the familiar acronym LAPS. LAPS includes the following 
networking protocols based on the Network Driver Interface Specification (NDIS) 
standard: 

• NetBIOS 

• TCP/IP 

• IEEE 802.2 

• IPX/SPX over NDIS support 

• NetBIOS over TCP/IP 

• NetBIOS over IPX support 

With LAPS, you will also have virtual IEEE 802.2 and NetBIOS support for DOS 
and Windows application running on your OS/2 Warp Server system. 

A wide range of LAN adapters for token-ring, Ethernet and FDDI are included as 
well as WAN adapters and serial and parallel communications support for NDIS. 
A complete list of adapters supported by Adapter and Protocol Services can be 
found in the \IBMCOM\MACS\READMAC.TXT file. Figure 92 on page 127 shows 
an overview of the LAPS component of Adapter and Protocol Services. 



126 



Inside OS/2 Warp Server, Volume 1 




IEEE 802.2 

Application Programs 



DOS /Windows 
NetBIOS & IEEE 602.2 
Application Programs 



Ring 3 1 



Ring 0 



IEEE 802.2 DL API 

(ACSLAN DLL) 



? I...A 

IEEE 802.2 DD API i 

(LANCLLDD OS2) i 



JL 







1 


\ 


1 Virtual Device Drivers 

(LANPDD SYS) 
(LANVDD.SYS) 



NetBIOS Application Programs 



NatBIOS NB30 DL API 

(ACSNIETB DLL) 



NetBIOS NB30 DD API 

(NETBIOS OS2) 



TCP/IP - Sockets 
Application Programs j 



Sockets API 

(S032DLL.DLL) 



t 

Common Transport 
Semantics - CTS 

(SOCKETS.SYS) 



IEEE 802.2 



NetBIOS LM10API 
Native NetBIOS 



L 

NetBIOS LM10API 
; NetBIOS over TCP/IP 



1 . 



; TCP/IP Protocol Stack 

j (AFINET.SYS) 



NetWare Support 




(LANDDOS2) 


i NDIS Protocol Driver ; 
! (NETBEUI OS2) 


1 NDIS Protocol Driver ; 
(TCPBEUIOS2) 


r 








(ODI2NDI.OS2) 










(IFN DIS.SYS) 



NDIS Protocol Manager 

( PROTMAN.OS2) 



Network Adapters 

NDIS MAC Drivers 


, 


= 


HSE 



Figure 92. LAN Adapter and Protocol Support (LAPS) Overview 



Note: Virtual TCP/IP support for DOS and Windows applications is also provided 
with OS/2 Warp Server, but that is included in TCP/IP Services. Please 
see Chapter 5, “TCP/IP Services” on page 167 for more information on 
that topic. 

Note: Virtual NetWare IPX and SPX support for DOS and Windows applications 
is also provided with OS/2 Warp Server, but that is part of the NetWare 
Requester for OS/2. Please see 4.5, “NetWare Requester for OS/2” on 
page 157 for more information on that topic. 



The files that make up LAPS and its configuration are placed under the 
\IBMCOM directory tree on the OS/2 boot drive. 



Network Driver Interface Specification (NDIS) 

IBM's transport strategy is based on the Network Driver Interface Specification 
(NDIS) - a standard jointly developed by 3COM and Microsoft Corporation. NDIS 
allows different network protocols to operate over the same LAN interface at the 
same time. 



NDIS is a standardized Medium Access Control (MAC) interface for network 
adapter drivers and protocol drivers. It has become a de facto industry 
standard, providing a common, open interface that enables different 
manufacturers of network adapters and LAN software developers to produce 
products which communicate with each other. 
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NDIS separates protocol handling from hardware manipulation by defining 
functions that protocol drivers and network adapter drivers must provide to each 
other. 

NDIS defines: 

• Specifications for network protocol drivers 

• Specifications for network adapter drivers 

• Interface between the above two layers 

• Binding process to link these protocol and adapter drivers 

A network protocol driver provides the communication between an application 
and a network adapter driver. 

A network adapter driver , or MAC driver, provides the communication between a 
network adapter and a protocol. The main function of the network adapter driver 
is to support network packet reception and transmission. 

Each driver has an upper and a lower boundary. The drivers are linked together 
to form a stack by binding the lower boundary of one driver to the upper 
boundary of another driver. The MAC driver at the bottom of the stack always 
has its lower boundary connected to the physical layer - the network adapter 
hardware. 

The NDIS specification defines the binding process of the drivers. Three 
components are used to form and manage the protocol stack from individual 
drivers. These are: 

PROTOCOL.INI 

An ASCII file that defines the protocol drivers and adapter drivers in use 
and their binding information. 

PROTMAN.OS2 

A Protocol Manager. 

NETBIND.EXE 

Initiates the final binding process. 

The LAPS component of Adapter and Protocol Services contains the above three 
files, the protocol and adapter drivers and a utility for easy installation and 
configuration of the required drivers. LAPS also contains Virtual Device Drivers 
which make the installed protocols available to DOS and Windows sessions 
under OS/2, without the need for specific DOS protocol drivers. 

Figure 93 on page 129 provides an illustration of an NDIS protocol stack in 
comparison to both the OSI reference model and the IEEE model. 
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Figure 93. ND/S, OS I and IEEE Comparison 



Multiple Protocol Support 

NDIS allows multiple protocols to be bound to a single MAC driver - that is, to 
share a network adapter. Figure 94 shows the NDIS protocol stacks when 
NetBIOS, IEEE 802.2 and TCP/IP are loaded together. In this example, two LAN 
adapters are in use. NetBIOS and IEEE 802.2 are bound to one of the adapters, 
and the other adapter is dedicated to the TCP/IP protocol {although there is no 
reason why all three protocols could not have been bound to both adapters). The 
configuration information defining which protocol(s) is bound to which adapter(s) 
is contained in the PROTOCOL.INI file. 




Figure 94. ND/S - Multiple Protocols 
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PROTOCOL.INI 

PROTOCOL.INI contains the NDIS configuration information for network adapter 
drivers and protocol drivers for a workstation. PROTOCOL.INI is an ASCII file 
that can be edited manually, but this is generally not recommended. We 
recommend that you always use the Adapter and Protocol Services configuration 
utility to ensure the creation of valid PROTOCOL.INI and CONFIG.SYS files. 
Please refer to 4.3, “Additional Configuration for Adapter and Protocol Services" 
on page 142 on more information on how to use the configuration utility. 

The PROTOCOL.INI file consists of four sections: 

• Protocol Manager 

• Configuration 

• Protocol drivers 

• MAC (network adapter) drivers 

All these sections have the following structure: 

[module name] 
parameter=val ue 

The following is an example of a PROTOCOL.INI file configured with both 
NetBIOS and TCP/IP protocol stacks (similar to Figure 94 on page 129). The first 
entry is the protocol manager, which is the driver that controls the binding 
process. 

[PR0T_MAN] 

DRIVERNAME = PR0TMAN$ 

The configuration section defines which protocols are used and what types of 
adapters are configured. In the following example, netbeui nif and tcpbeui_nif 
are the protocol drivers, and IBMTOK nif is the adapter configuration (in this case 
an IBM Token-Ring adapter). 

[IBMLXCF6] 

netbeui_nif = netbeui.nif 
tcpip_nif = tcpip.nif 
IBMT0K_ni f = IBMTOK.NIF 

The Bindings= statements under the various protocol drivers specifies the 
module name of the MAC driver to which the protocol driver will bind to form a 
protocol stack or stacks. In this example, NetBIOS, the NetBIOS API is using the 
NetBEUI protocol driver, which itself is bound to the token-ring MAC driver. 
TCP/IP is also bound to the token-ring MAC driver. 

[NETBIOS] 

DriverName = netbios$ 

ADAPTER© = netbeui$,0 

[netbeui_nif] 

DriverName = netbeui$ 

Bindings = IBMTOK_nif 

[tcpipjiif] 
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DriverName = TCPIP$ 

Bindings = IBMTOK_nif 

[IBMTOK_ni f] 

DriverName = IBMTOK$ 

More statements of the kind of parameter=val ue may appear under each protocol 
and MAC section. The meanings of parameter and the allowed ranges and types 
for value are contained in network information (.NIF) files which exist for each 
protocol and MAC driver. The configuration program parses those NIF files to 
check what can be configured for any given section in PROTOCOL.INI and if a 
configuration item is valid. If no additional parameters are specified in the 
PROTOCOL.INI sections, default values will be used as defined in the .NIF files. 

NDIS NETBIND Process 

When a workstation is initialized, the following process takes place: 

t. The Protocol Manager is the first NDIS-related driver to be initialized during 
the CONFIG.SYS process. During initialization, the Protocol Manager reads 
the PROTOCOL.INI file. 

2. The information in PROTOCOL.INI is parsed into an image table that is 
accessible to other NDIS drivers. 

3. As CONFIG.SYS processing continues, other drivers are loaded. As each is 
initialized, the related information in the image table is read. The NDIS 
driver then registers with the Protocol Manager. 

After all drivers and protocols are processed, the Protocol Manager has a 
list of active NDIS drivers and their desired bindings. 

4. A NETBIND is issued, and the desired bindings take place. 

Socket/Multiprotocol Transport Services (MPTS) 

The Sockets interface allows you to develop distributed or client/server 
applications using various transport protocols. The application can select the 
transport protocol or request that the Socket/MPTS layer determine the protocol. 
Most socket applications available today communicate with either TCP or UDP. 

Sockets are duplex, which means that data can be transmitted and received 
simultaneously. Sockets allow you to send to, and receive from, the socket as if 
you are writing to and reading from any other network device. 

Socket/MPTS provides the support for three kinds of address families for the 
Sockets application programming interface (API): 

1. TCP/IP address family (AFJNET) 

2. NetBIOS address family (AFNB) 

3. OS/2 address family (AF OS2) 

It also provides a local IPC transport for Sockets applications (inter-process 
communications support that does not issue any calls to the network). 

Figure 95 on page 132 shows an overview of Socket/MPTS. 
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Figure 95. Socket/MPTS Overview 

As you can see from comparing Figure 92 on page 127 and Figure 95, the LAPS 
and MPTS components overlap on the TCP/IP Sockets support and protocol 
stack. Whereas LAPS merely allows the TCP/IP protocol to be added to an 
adapter configuration, MPTS allows the user to select and configure the 
appropriate Sockets support, and it also contains the files that make up Sockets 
and TCP/IP in the bsl.MPTN directory tree on the OS/2 boot drive. 

If a Sockets application has been coded to use a certain address family, it would 
normally be bound to the transport protocol that this address family supports. 
That is, for example, an application using the AFJNET address family would also 
use TCP/IP as its transport protocol. This is called native transport. 

If you need to run that application over a different transport, and there were only 
support for native transport, you would have to rewrite the application to use the 
address family that is native to the other transport protocol. With the 
Multiprotocol Transport Network (MPTN) architecture and the AnyNet product 
family, however, IBM introduces the capability of non-native networking. That 
means that an application can use any transport network, even if that transport 
is not natively supported by the application. In that case, the above program, 
which has been coded to use the AFJNET address family, could use, for 
instance, the NetBIOS protocol without having to be re-written to use the AFNB 
address family. 

Using Socket/MPTS on its own allows ONLY native networking of Sockets 
applications (AFJNET over TCP/IP, AF_NB over NetBIOS, AF OS2 over local 
I PC). However, this release of MPTS, also known as the Converged Stack, allows 
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coexistence with the IBM AnyNet/2 product. AnyNet/2 also introduces an SNA 
services driver, which means that running TCP/IP applications over SNA or 
NetBIOS applications over SNA is also made possible. For more details about 
AnyNet/2 and non-native Sockets, please refer to Inside OS/2 Warp Server, 
Volume 2: Using SystemView, Backup/ Recovery and Advanced Print which is 
planned to be available in May 1996. 



4.2 Installing Adapter and Protocol Services 

As this component of OS/2 Warp Server provides communication support to all 
other parts of the product, it will always be installed when you install an OS/2 
Warp Server system. Therefore, it cannot be explicitly selected on the OS/2 Warp 
Server Setup and Installation Menu. 

Note: If you are installing OS/2 Warp Server remotely in unattended mode 

(response file installation method using CID), then you must include the 
Adapter and Protocol Services component in the installation procedures. 
Otherwise, your system will not be working, apart from base OS/2. 

Adapter and Protocol Services will attempt to detect and identify any LAN 
adapters that are installed in your system. See the 

\IBMCOM\MACS\READMAC.TXT file for a list of adapter drivers which are 
supplied with OS/2 Warp Server. However, only the first adapter that could be 
found will be automatically included in the configuration. You may add more 
adapters, and you may add additional adapter drivers which are not included in 
OS/2 Warp Server, which we will show later. 

As far as network protocols are concerned, the initial configuration of Adapter 
and Protocol Services depends on the features which you have selected to be 
installed. The following explains how each protocol is automatically installed: 

• The IBM NetBIOS protocol will be automatically configured if any of the 
following components are selected: 

— File and Print Sharing Services 
— Remote Access Services 

— Systems Management Services with NetBIOS protocol enabled 
— Software Backup and Recovery Services with LAN backup option 
selected 

• The IBM TCP/IP protocol will be automatically configured if any of the 
following components are selected: 

— TCP/IP Services 

- Systems Management Services with TCP/IP protocol enabled 
— Advanced Printing Services with TCP/IP printing option selected 

• The NetWare Requester Support driver will be automatically configured if any 
of the following components are selected: 

— File and Print Sharing Services with NetWare File Sharing Gateway 
feature 

— Systems Management Services with IPX protocol enabled 

• The IEEE 802.2 protocol will always be automatically configured. 

Figure 96 on page 134 shows the OS/2 Warp Server Configuration menu with a 
possible initial configuration for Adapter and Protocol Services: 
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Figure 96. Initial Adapter and Protocol Services Configuration 

The following table summarizes the configuration parameters of this page and 
describes their purposes. 



Table 17 (Page 1 of 2). Adapter and Protocol Services Installation 


Configuration Item 


Configuration Data 


Change adapter 


Press this button if you want to change a network adapter for 
the current configuration. This may be necessary if the 
installation program could not detect your adapter 
configuration properly. 


Add adapter 


Press this button if you: 

1 . Want to add an adapter to your configuration 

2. Want to add a new adapter driver which is not supplied 
with Adapter and Protocol Services 

This will bring up the menu that is shown in Figure 97 on 
page 135. 


Add protocol 


Press this button if you: 

1 . Want to add a protocol to your configuration 

2. Want to add a new protocol driver which is not supplied 
with Adapter and Protocol Services 

This will bring up the menu that is shown in Figure 98 on 
page 136. 


Settings 


Press this button if you want to change the parameters for any 
item in the configuration list. This will bring up the menu that 
is shown in Figure 99 on page 136. 


Remove 


Press this button if you want to remove an item from the 
configuration list. You can only remove one item at a time. 

Note: You can only remove an adapter if you have previously 
removed all protocols that have been associated with 
that adapter. 
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Table 17 (Page 2 of 2). Adapter and Protocol Services Installation 


Configuration Item 


Configuration Data 


Change number 


Press this button if you need to change the logical sequence in 
which a protocol driver will address adapters if this protocol 
has been associated with more than one adapter. Application 
programs will use these numbers when they issue calls to the 
network interface(s). 



If the LAN adapter in your system is not supplied with OS/2 Warp Server, but you 
have an NDIS compliant OS/2 device driver for that adapter, click on the Add 
adapter button. The following menu will be shown: 



Add Adapter 



Choose the network adapter installed on this 
workstation. 



Network adapter 




Cancel 



OK 



1 | Other adapter... 



Help 



Figure 97. Add Adapter Driver to Adapter and Protocol Services 

To add a supplied adapter to your configuration, select the appropriate driver 
from the list, then press OK. To add a new adapter driver, select Other adapter..., 
then specify the source drive from where the new driver will be copied to your 
system. 

If you want to use a protocol that is not supplied with OS/2 Warp Server, but you 
have an NDIS compliant OS/2 device driver for that protocol, click on the Add 
protocol button. The following menu will be shown: 
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Add Protocol 



111 

Choose the protocols to be used with the selected adapter. 



Network adapter: 

IBM Token-Ring Network Adapter 



Protocol: 



IBM NETWARE REQUESTER SUPPORT 
IBM OS/2 NETBIOS 
IBM OS/2 NETBIOS OVER TCP/IP 
IBM TCP/IP 

NETWARE NETBIOS EMULATION OVER IPX - IBM 



m 





| Other protocol... 


! Cancel 

L _ 


Help 



Figure 98. Add Protocol Driver to Adapter and Protocol Services 

To add a supplied protocol to your configuration, select the appropriate driver 
from the list, then press OK. To add a new protocol driver, select Other 
protocol..., then specify the source drive from where the new driver will be 
copied to your system. 

Adding an adapter or protocol may affect the configuration of other OS/2 Warp 
Server components, so you may want to check the items on the configuration 
tree again. For instance, adding the NetBIOS over TCP/IP protocol will result in 
another LAN adapter which can be selected for File and Print Sharing Services. 

If you want to view or change the configuration of any adapter or protocol driver, 
select the appropriate item on the list, then click on the Settings button. The 
following menu will be shown: 



Parameters for IBM OS/2 NETBIOS 



Edit the parameters as needed. 



Parameters 


Value 












Type of Ethernet driver support 


1 






Universally administered address reversed 


YES 






NETBIOS trace level 


0x0 






Maximum sessions 


254 




V//, 


Maximum commands 


254 




y/; 


Maximum names 


42 




■aA; 

% 


GDT selectors 


15 




% 


Full buffer datagrams 


NO 




y 

4 


Adaptive windowing interval 


1000 




m 




n 




m 




I 



Change 



OK 




Cancel 




Help 



Figure 99. Change Settings in Initial Adapter and Protocol Services Configuration 
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Note: In this menu, you can only change one item at a time. This is different 

from the configuration menu that you can use after OS/2 Warp Server has 
been completely installed. See 4.3, "Additional Configuration for Adapter 
and Protocol Services” on page 142 for more information on this topic. 

Calculating Memory Requirements for Adapter and Protocol Services 

Adapter and Protocol Services need to allocate a certain amount of system 
memory for establishing the protocol stacks that you have selected to use. This 
section will inform you about how to calculate memory requirements for different 
protocol stacks. 

Some of the following tables and formulas are used as a base for the File and 
Print Sharing Services Tuning Assistant program which is described in 2.5, 

“OS/2 Warp Server Tuning Assistant” on page 15. 

NetBEUI RAM Usage 

The following table summarizes the memory usage of the NetBEUI protocol 
driver (NETBEUI. OS2). When calculating the total memory requirements, multiply 
the number of each parameter as specified in the PROTOCOL.INI file by the 
number of bytes per item as shown in the table below. 

Note: All but the requirements for Sessions and Remote Name Cache must fit 
within a 64KB address space (65535 bytes). The requirements for 
Sessions and Remote Name Cache will be satisfied from system memory 
outside that 64KB area. 



Table 18. Memory Calculations for NetBEUI 


Data area item 


Related configuration 
parameter 


RAM usage 
in bytes 


Overhead for device driver memory allocation and communication 
area 


7144 


Each NetBIOS session 


SESSIONS 


700 


Each NetBIOS command 


NCBS 


64 


Each NetBIOS name in the local 
names table 


NAMES 


76 


Each data descriptor to allocate 
for GDT selectors 


SELECTORS 


10 


Each NetBIOS name in the 
remote name table (cache) 


NAMECACHE 


60 


Each l-frame packet descriptor 


PACKETS 


108 


Each U l-frame packet 
descriptor 


DATAGRAM PACKETS 


124 


Each loopback packet 
descriptor 


LOOPPACKETS 


148 



The following example shows how to calculate RAM usage for NETBEUI 
parameters, assuming the defaults are being used as specified in the 
\IBMCOM\PROTOCOL\NETBEUI.NIF file: 



Parameter 


Count 


RAM Usage 


Parameter Total 


Overhead 


1 


* 7144 


= 7144 


Comnands 


225 


* 64 


= 14400 
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Names 


21 


wm 




= 


1596 


Selectors 


15 




mm 


= 




Packets 


350 




o 


= 




Datagrampackets 


10 




mm 


= 




Loop Packets 


8 




1 m 


= 


1184 


check for 64KB limit: 










63514 OK 


Sessions 


130 


* 


700 


8 


91000 


Remote Name Cache 


1000 


* 


60 


= 


60000 



Total RAM usage for NETBEUI parameters: 214514 



TCPBEUI RAM Usage 

The following table summarizes the memory usage of the TCPBEUI protocol 
driver (TCPBEUI. OS2). When calculating the total memory requirements, multiply 
the number of each parameter as specified in the PROTOCOL.INI file by the 
number of bytes per item as shown in the table below. 

Note: All but the requirements for Sessions and Namecache must fit within a 
64KB address space (65535 bytes). The requirements for Sessions and 
Namecache will be satisfied from system memory outside that 64KB area. 



Table 19. Memory Calculations for TCPBEUI 


Data area item 


Related configuration 
parameter 


RAM usage 
in bytes 


Overhead for device driver memory allocation and communication 
area 


8260 


Each NetBIOS session 


SESSIONS 


382 


Each NetBIOS command 


NCBS 


60 


Each NetBIOS name in the local 
names table 


NAMES 


91 


Each data descriptor to allocate 
for GDT selectors 


SELECTORS 


10 


Each NetBIOS name in the 
remote name table (cache) 


NAMECACHE 


40 


Each TCP packet descriptor 


PACKETS 


114 


Each UDP packet descriptor 


DATAGRAMPACKETS 


1142 



The following example shows how to calculate RAM usage for TCPBEUI 
parameters, assuming the defaults are being used as specified in the 
\IBMCOM\PROTOCOL\TCPBEUI.NIF file: 



Parameter 


Count 




RAM Usage 


Parameter Total 


Overhead 


1 


* 


8260 


= 8260 


Comnands 


225 


* 


60 


= 13500 


Names 


21 


* 


91 


= 1911 


Selectors 


15 


* 


10 


= 150 


Packets 


50 


* 


114 


= 5700 


Datagrampackets 


20 


* 


1142 


= 22840 


check for 64KB limit: 








52361 OK 


Sessions 


130 


* 


382 


= 49660 


Remote Name Cache 


1000 


* 


40 


= 40000 
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Total RAM usage for TCPBEUI parameters: 



142021 



NetBIOS API RAM Usage 

The following table summarizes the memory usage of the NetBIOS API driver 
(NETBIOS.OS2). When calculating the total memory requirements, multiply the 
number of each parameter as specified in the PROTOCOL.INI file by the number 
of bytes per item as shown in the table below. 

Note: All the requirements for this driver must fit within a 64KB address space 
(65535 bytes). 



Table 20. Memory Calculations for NetBIOS 


Data area 
item 


Related configuration 
parameter 


RAM usage in bytes 


Overhead for device driver memory allocation 
and communication area 


11310 


Commands 


Add all NCBS that are specified 
for all logical adapters which 
are bound to use the NetBIOS 
API, then subtract all NCBS that 
are reserved for the OS/2 LAN 
Server/Requester redirector 
(NETWKSTA.SYS) as specified 
in the \IBMLAN\IBMLAN.INI 
file, then calculate. 


95 * (# of NCBS - # of NCBS 
used by redirector) 


Commands 


Add all NCBS that are specified 
for all logical adapters which 
are bound to use the NetBIOS 
API, then subtract all NCBS that 
are reserved for the OS/2 LAN 
redirector (NETWKSTA.SYS), as 
specified in the 

\IBMLAN\IBMLAN.INI file, then 
calculate. 


15* (# of NCBS - # of NCBS 
used by redirector - 1 5) or 0, if 
less than 15 NCBS 


Adapters 


Add all adapters that are bound 
to the NetBIOS API, as 
specified in the 

\IBMC0M\PR0T0C0L.INI file, then 
subtract all adapters that are 
being used by the OS/2 LAN 
redirector (NETWKSTA.SYS), as 
specified in the NETx 
statement(s) in the 
\IBMLAN\IBMLAN.INI file, then 
calculate. 


990 * (# of adapters - # of 
adapters used by redirector) 



The following example shows how to calculate RAM usage for the NetBIOS API 
when using the parameters from the two previous examples, and assuming that: 

1. Three adapters are using the NetBIOS API, which can be seen in the 
following example of a PROTOCOL.INI file: 
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[PROT_MAN] 

DRIVERNAME = PROTMAN$ 

[NETBIOS] 

DriverName = netbios$ 

ADAPTER0 = netbeui$,0 
A0APTER1 = tcpbeui$,l 
ADAPTER2 = netbeui$,2 

[netbeui_nif] 

DriverName = netbeui$ 

Bindings = IBMTOKC_nif,,MACETH_nif 

[tcpbeui_nif] 

DriverName = tcpbeui$ 

Bindings = ,IBMTOKC_nif 

[IBMT0K_ni f] 

DriverName = IBMT0K$ 

[MACETH_nif] 

DriverName = MACETH$ 

2. Two adapters are used by the OS/2 LAN redirector, which can be seen in the 
following example of an IBMLAN.INI file: 

[networks] 

netl = netbeui$,0,LM10,34,70,14 
net2 = tcpbeui$,l,LM10,34,70,14 

Resulting NetBIOS RAM calculation: 



Parameter 


Count 


RAM Usage 


Parameter Total 


Overhead 


1 


* 11310 


= 11310 


# NCBS 


675 






# NCBS for redirector 


- 140 






remaining Conmands 


535 


* 95 


= 50825 


remaining Conmands -15 


520 


* 15 


= 7800 


# Adapters for API 


3 






# Adapters for redirector 2 






Adapters 


1 


* 990 


= 990 


check for 64KB limit: 






70925 BAD 



Total RAM usage for NetBIOS parameters: 70925 

The NetBIOS API will then not be available to applications that rely on the NB30 
NetBIOS interface, such as Systems Management Services and Software Backup 
and Recovery Services. Applications that can use the LM10 NetBIOS interface, 
such as File and Print Sharing Services, will not be affected. 

To overcome this NetBIOS limit: 

1. Increase the number of NOBS that the OS/2 LAN redirector can use to a 
value of at least 95 each (or a total of 190), or 

2. Decrease the number of NOBS per instance of NetBIOS to a value of at most 
208 each (or a total of 625). 
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Note: The LAN Distance logical adapter must be included in the above 
calculation! 

IEEE 802.2 RAM Usage 

The following table summarizes the memory usage of the IEEE 802.2 protocol 
driver (LANDD.OS2). When calculating the total memory requirements, multiply 
the number of each parameter as specified in the PROTOCOL.INI file by the 
number of bytes per item as shown in the table below. 

Note: All but the requirements for Link Stations (LS) and Timer Control Blocks 
(TCBs) must fit within a 64KB address space (65535 bytes). The 
requirements for LS and TCBs will be satisfied from system memory 
outside that 64KB area. 



Table 21. Memory Calculations for IEEE 802.2 


Data area item 


Related configuration 
parameter 


RAM usage 
in bytes 


Overhead for device driver memory allocation and communication 
area 


5460 


Each link stations 


LINKS 


290 


Each service access point 
(SAP) 


MAXSAPS 


120 


Each group SAP 


MAX_G_SAPS 


30 


Each application using this 
interface concurrently 


USERS 


90 


Each l-frame command control 
block (CCB) 


1 PACKETS 


110 


Each UI-, TEST-, XI D-, and 
DIR-frame command control 
block (CCB) 


Ul PACKETS 


140 


Each timer control block (TCB) 


TCBS 


30 



The following example shows how to calculate RAM usage for IEEE 802.2 
parameters, assuming the defaults are being used as specified in the 
\IBMCOM\PROTOCOL\LANDD.NIF file: 



Parameter 



Count 



RAM Usage Parameter Total 



Overhead 


1 


* 


5460 




5460 


Service Access Points 


3 


* 


120 


= 


360 


Group SAPs 


0 


* 


30 


= 


0 


Users 


3 


* 


90 


= 


270 


I -frames 


250 


* 


110 


= 


27500 


UI -frames 


100 


* 


140 


= 


14000 


check for 64KB limit: 










47590 OK 


Link Stations 


8 


* 


290 


s 


2320 


Timer Control Blocks 


64 


* 


30 


= 


1920 



Total RAM usage for IEEE 802.2 parameters 51830 
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4.3 Additional Configuration for Adapter and Protocol Services 

If you want to make changes to the configuration of Adapter and Protocol 
Services after OS/2 Warp Server has been installed, you can easily do so by 
using the Adapter and Protocol Services configuration program. To start this 
program, either, click on the Adapter and Protocol Services icon in the System 
Setup folder, or type the following command at an OS/2 command prompt: 

MPTS 

Then select Configure so it will bring up the panel shown in Figure 100. 



Configure 



Select an Item below, then select Configure. Once you return to 
this panel you can select another Item or select Close to save your 
configuration. 



Adapters and Protocols 
: M . jLAN ad a pt ers and p rot o cols 
si Migrate a CM 1.3 .CFG file 

Socket/MPTS transport access 
ki TCP/IP Configuration 



NetBIOS Socket access 
Close Configure I ; Remove 



Status 

Configured 



Cancel 



Not configured 
Not configured 
Help 



Figure 100. Adapter and Protocol Services - Configure Options 

Select LAN adapters and protocols and choose Configure to bring up the LAPS 
Configuration window. Use this configuration panel to select the LAN adapters) 
installed on the workstation and the protocols associated with them. Figure 101 
on page 143 shows an example of what an Adapter and Protocol Services 
configuration might look like: 



142 



Inside OS/2 Warp Server, Volume 1 





I. APS-Conligurntion 



Select a network adapter and then select protocols to go with it. 
l-Network Adapters , r Protocols- 






3Com 3C523 EtherLink/MC Adapter 
3Com EtherLink III Family OS/2 
3Com TokenLlnk III Network Adapters 



Add 


Change 


Other adapters... 


Add 






IBM IEEE 602.2 
IBM OS/2 NETBIOS 
IBM Netware Requester SupE 



Other protocols... 



Current Configuration 

T o edit driver parameters, select an item below and 
then select Edit. 






9 - IBM IEEE 802.2 
0 - IBM OS/2 NETBIOS 
0 - IBM TCP/IP 



Edit 



Remove Change number... 



Select OK when 
complete. 



DKj 



Cancel 



Help 



Figure 101. LAPS Configuration 

The following table summarizes the use of this configuration menu: 



Table 22. Adapter and Protocol Services Configuration 


Configuration Item 


Configuration Data 


Network Adapters window 


Add 


Press this button if you want to add an adapter to your 
configuration. 


Change 


Press here if you want to change a network adapter for the 
current configuration. 


Other adapters ... 


Press this button if you want to add a new adapter driver 
which is not supplied with Adapter and Protocol Services. 


Protocols window 


Add 


Press this button if you want to add an adapter to your 
configuration. 


Other protocols ... 


Press this button if you want to add a new adapter driver 
which is not supplied with Adapter and Protocol Services. 


Current Configuration window 


Edit 


Press here if you want to change the parameters for any item 
in the configuration list. This will bring up a menu where you 
can make changes to multiple parameters and then apply all 
changes at once. 


Remove 


Press here if you want to remove an item from the 
configuration list. You can only remove one item at a time. 

Note: You can only remove an adapter if you have previously 
removed all protocols that have been associated with 
that adapter. 


Change number ... 


Press this button if you need to change the logical sequence in 
which a protocol driver will address adapters if this protocol 
has been associated with more than one adapter. Application 
programs will use these numbers when they issue calls to the 
network interface(s). 
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If you have finished the configuration, press OK to save the changes. Press 
Close on the following panel, then press Exit. Select to update the CONFIG.SYS 
file on the OS/2 boot drive so that the configuration changes can be properly 
applied. You will need to reboot before the changes will become effective. 

Configuring Socket/MPTS 

Socket/MPTS is configured from the Configure panel when loading MPTS (see 
Figure 100 on page 142). Use this panel to select the protocols that you intend to 
use for Socket access. These selections notify Socket/MPTS to initialize the 
protocol services required. The selectable protocols are: 

1. TCP/IP Socket access 

2. NetBIOS Socket access 

To select TCP/IP Socket access, you must have the TCP/IP protocol configured 
(using the LAN adapters and protocols configuration option). To select NetBIOS 
Socket access, you must have the NetBIOS protocol configured (using the LAN 
adapters and protocols configuration option). You must select at least one 
protocol for your Socket/MPTS environment. However, you can select more than 
one protocol. 

Note: When you have installed TCP/IP Services, during the initial installation of 
your OS/2 Warp Server system or at any later time, you must use the 
TCP/IP Configuration notebook to configure TCP/IP parameters. In this 
case, the status text of the TCP/IP Configuration in the Configure menu 
(shown in Figure 100 on page 142) will inform you about this, and the 
Configure button will be grayed out. 

Please see 5.3, “Additional Configuration for TCP/IP Services” on 
page 173 for more information on how to use the TCP/IP Configuration 
notebook. 

Configuring TCP/IP Socket Access 

Select TCP/IP Socket access, then click on Configure. The following menu will be 
shown: 



TCP/IP Configuration 



Select one or more items below, then select Configure. When you 
are finished, select Close to save your configuration. 



Network interface parameters 1 
% Routing information 
IM Domain name services 



Close 



Configure 



Cancel 



Help 



Status 

Not configured 
Not configured 
Not configured 



Figure 102. TCP/IP Socket Access Configuration 

On this page, you can select what parts of the TCP/IP Socket access you want to 
configure. 

Select Network Interfaces, then click on Configure. The following menu will be 
shown: 
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Figure 103. TCP/IP Network Interface Configuration 



On this page, you can configure the TCP/IP network interfaces of your OS/2 Warp 
Server system. The following table summarizes the configuration parameters of 
this page and describes their purposes. 



Table 23 (Page 1 of 2). TCP/IP Network Interface Configuration 


Configuration Item 


Configuration Data 


Select LAN adapter 


Select a LAN adapter, then click on Activate to 
make it available for TCP/IP Socket access. 


Use DHCP support 


Check, if you want the DHCP client to 
automatically configure this interface with 
parameters obtained from a DHCP server, if one 
exists on the network. 


IP address 


The IP address of this interface to the IP network 


Subnet mask 


This is the value obtained from your network 
coordinator to define the network range of . your 
IP address. 


Broadcast 


The broadcast address for your IP network, 
derived from the combination of your IP address 
and subnet mask. This will be calculated 
automatically by TCP/IP. 


Destination address 


The base address of your IP network, derived 
from the combination of your IP address and 
subnet mask. This will be calculated 
automatically by TCP/IP. 


Metric count 


The number of hops that can be used to access 
another IP address. 


Maximum transmission unit 


Specify the maximum IP packet size for that 
interface. The default is 1500 bytes. 
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Table 23 (Page 2 of 2). TCP/IP Network Interface Configuration 


Configuration Item 


Configuration Data 


Single route broadcast 


Use this field to set the token ring broadcast 
indicator. All-Routes broadcast allrs is the 
default. 


Disable use of ARP 


Use this field to enable the use of the Address 
Resolution Protocol (ARP) for mapping between 
IP addresses and LAN adapter addresses. 
Default is enabled. 


Disable routing 


Use this field to enable source routing 
information in token-ring packets. 


Disable extended SNAP 


Use this field to send TCP/IP packets with 
headers that have the extended SNAP header 
format. 


Trailer encapsulation 


Use this field to request the use of a trailer link 
level encapsulation when sending messages. 


Enable 802.3 


Use this field to disable Ethernet 802.3 and 
enable Ethernet DIX2. 


Disable ICPM redirects 


Use this field to allow or deny TCP/IP to add 
routes obtained by ICMP redirects. 


Canonical address 


Use this field to indicate that MAC addresses in 
the Address Resolution Protocol (ARP) packet on 
this token-ring network are in the canonical IEEE 
802.5 form. 



Click on OK to finish this configuration. 

If you want to use DHCP to automatically configure the TCP/IP parameters for 
your OS/2 Warp Server system, click on DHCP. The Network Interface 
Configuration menu will now look as shown in the figure below: 



Configure TCP/IP network Interface Parameters 



r Select LAN adapter- 



wmwmmmmmwmmmmmmmm. 



LAN Adapter t - NONACTIVE 
LAN Adapter 2 - NONACTIVE 
LAN Adapter 3 - NONACTIVE 



Activate 



Deactivate 



IgiUse DHCP support 



j|| Use DDNS 



OK 



Cancel 



Help 



Figure 104. TCP/IP Network Interface Configuration Using DHCP 
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On this page, you can only select whether or not you want to use DDNS in 
addition to DHCP. All other parameters will be set according to the information 
that the DHCP client will retrieve from a DHCP server when you restart the 
system. 

Click on OK to finish this configuration. 

The remaining configuration options need not be selected if you chose to use 
DHCP with this system but you can configure them if you need to. 

Select Routing Information, then click on Configure. This wilt bring up a menu 
similar to Figure 127 on page 178. See “Configure Routers” on page 178 for 
more information on how to configure TCP/IP routing information. 

Click on OK to finish this configuration. 

Select Nameserver, then click on Configure. This will bring up a menu similar to 
Figure 129 on page 180. See “Configure Hostnames and Nameservers” on 
page 179 for more information on how to configure TCP/IP nameserver 
information. 

Click on OK to finish this configuration. 

When you finished the TCP/IP Socket access configuration, click on Close to 
return to the Configuration menu. 

Configuring NetBIOS Socket Access 

Select NetBIOS Socket access, then click on Configure. The following menu will 
be shown: 



Coiifkjure NetBIOS Sockets Parameters 



Maximum values 



Sessions 

NCBs 

Names 

NetBIOS hostname 



58 



86 



42 



MARTIN 



OK 



Cancel 



Help 



254 

254 

42 



View Details. 



Figure 105. Sockets Access Configuration 



On this page, you can configure the NetBIOS interfaces of your OS/2 Warp 
Server system for Socket access. The following table summarizes the 
configuration parameters of this page and describes their purposes. 
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Table 24. NetBIOS Interface Configuration for Socket Access 


Configuration Item 


Configuration Data 


Sessions 


Specify the number of NetBIOS sessions that you 
want to reserve for Sockets applications. The 
number of sessions specified here will be taken 
from the total amount of sessions specified in the 
NETBEUI section of the PROTOCOL.INI file. This 
means that the amount of sessions available to 
other NetBIOS applications, such as File and Print 
Sharing Services, will be reduced by the number 
specified here. 


NCBs 


Specify the number of NetBIOS commands 
(NCBs) that you want to reserve for Sockets 
applications. The number of NCBs specified here 
will be taken from the total amount of NCBs 
specified in the NETBEUI section of the 
PROTOCOL.INI file. This means that the number 
of NCBs available to other NetBIOS applications, 
such as File and Print Sharing Services, will be 
reduced by the number specified here. 


Names 


Specify the number of NetBIOS names that you 
want to reserve for Sockets applications. The 
number of names specified here will be taken 
from the total amount of names specified in the 
NETBEUI section of the PROTOCOL.INI file. This 
means that the amount of names available to 
other NetBIOS applications, such as File and Print 
Sharing Services, will be reduced by the number 
specified here. 


NetBIOS hostname 


Enter the hostname that your NetBIOS Sockets 
applications will be using. 


View Details... 


Click here to see more available hostnames. 
When the NetBIOS protocol is configured to more 
than one adapter, Socket/MPTS will use the 
hostname that you have specified for the first 
interface, and it will add to that name unique 
identifiers (consecutive numbers) and use that as 
hostnames for the other interfaces. 



When you finished the TCP/IP Socket access configuration, click on Close to 
return to the Configuration menu. 

You can use the NETSTAT program to see if the NetBIOS Sockets interface is 
initialized, and what applications are currently using it. 

Removing Socket/MPTS Configuration 

When you want to remove a Socket/MPTS configuration from your OS/2 Warp 
Server system, you can do it from the Configure panel when loading MPTS (see 
Figure 100 on page 142). Select the appropriate Socket access protocol to be 
removed (TCP/IP or NetBIOS), then click on Remove. If you want to remove both 
protocols, you can do so by removing one after the other. 

Note: Removing a Socket access protocol will not remove the protocol driver 
from the LAN adapter and protocol configuration. It will only update the 
\MPTN\BIN\MPTCONFG.INI file and remove device drivers from the 
CONFIG.SYS file. 
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New Configuration Parameters for NetBEUI Protocol Driver 

The NETBEUI section of the PROTOCOL.INI file has two configurable parameters 
that are not listed before in the formal documentation, SIDEBAND and BALANCE. 
These parameters should not be changed from their default values. When not 
present in the PROTOCOL.INI file, these two parameters are set to the correct 
values automatically. The default values (when not present in PROTOCOL.INI) 
are as follows: 

SIDEBAND = 1 
BALANCE = 2 

Setting SIDEBAND to 1 enables a performance enhancement used by File and 
Print Sharing Services for sending small frames. Setting SIDEBAND to 0 disables 
this performance enhancement. 

BALANCE is used to control how NetBEUI chooses which adapters are used 
when an NCB.LISTEN command is issued on a machine with multiple network 
adapters. If two network adapters on the same machine are on the same 
network segment (bridged segment) then setting BALANCE to 0 disables load 
balancing, setting BALANCE to 1 puts it into load balancing mode and setting 
BALANCE to 2 lets NetBEUI decide the appropriate load balancing mode. 

Configuring Adapter and Protocol Services for more than Four LAN Adapters 

Adapter and Protocol Services itself is not limited to four adapters as is the NB30 
NetBIOS API, as discussed below. Adapter and Protocol Services support 
includes LAN adapters as well as other NDIS communication adapter drivers, 
such as asynchronous and parallel port support, WAN and ISDN. The number of 
adapter drivers that can actually be used concurrently differs between the NDIS 
protocol drivers. The TCP/IP, IEEE 802.2 and NetWare Requester Support protocol 
drivers can support up to 64 adapters. The NetBIOS protocol drivers (IBM 
NETBEUI, IBM NetBIOS over TCP/IP, NetWare NetBIOS Emulation) will only 
support four adapters, which is the limit of the NB30 NetBIOS API. 

Since all NetBIOS drivers that are supplied with OS/2 Warp Server also support 
the LM10 NetBIOS API, there is no restriction to four adapters when this 
interface is used by applications. This will increase the number of clients that 
can be simultaneously connected to OS/2 Warp Server over NetBIOS. It will also 
help the session load balancing performed by File and Print Sharing Services. 

In the following example, we used four DUAL Auto LANStreamer adapter cards 
that provide two separate token-ring ports each. This gives us a total of eight 
LAN adapters as seen by NDIS. Figure 106 on page 150 shows how these 
adapters can be interfaced by NetBIOS applications. NB30 applications will only 
be able to interface with four adapters, whereas LM10 applications, such as File 
and Print Sharing Services, will be able to interface with all eight adapters which 
are bound to the NetBEUI protocol driver. 



Chapter 4. Adapter and Protocol Services 149 




NetBIOS Application Programs j 



NetBIOS NB30 DL API 

(ACSNETB.DLL) 



NetBIOS NB30 DO API 

(NETBIOS.OS2) 



-\ 

••••■ v 






OS/2 LAN Redirector 

(NETWKSTA.200, 
HPFS386 IFS) 



: i , // 



j NetBIOS LM10 API j 
native NetBIOS 

NDIS Protocol Driver i 
(NETBEUI.OS2) 

ITTTfTTT 

NDIS Protocol Manager 

(PROTMAN OS2) 






Network Adapter(s) 

NDIS MAC Driver(s) 



Figure 106. NetBIOS Configuration for Eight Adapters 

The following lines are extracted from the CONFIG.SYS file to reflect what drivers 
must be loaded in order to support the configuration as shown above: 

DEVICE=C:\IBMC0M\MACS\DUALSTRM.0S2 /S: 3 
DEVICE=C:\IBMC0M\MACS\DUALSTRM.0S2 /S:4 
DEVICE=C:\IBMC0M\MACS\DUALSTRM.0S2 /S:6 
DEV I CE=C : \ I BMCOM\MACS\OUALSTRM . 0S2 /S:7 
DEVICE=C : \IBMCOM\LANMSGDD . 0S2 /I:C:\IBMC0M 
DEVICE=C:\IBMCOM\ PROTMAN. 0S2 /I:C:\IBMC0M 



Notes: 

1. You have to add the lines for the DUALSTRM.OS2 device driver manually. 

2. Make sure you add those lines before the PROTMAN. OS2 device driver 
statement, as shown in the example above. 

3. Include the /S parameter on every statement to specify the slot that the Dual 
LANStreamer adapter is plugged into. 

The following lines are extracted from the PROTOCOL.INI file to reflect what 
drivers must be loaded to support the configuration as shown above: 

[PR0T_MAN] 

DRIVERNAKE - PROTMANJ 
[IBMLXCFG] 
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netbeui nif = netbeui.nif 
IBMMPC_iiif = IBMMPC.NIF 
IBMMPC_nif2 » ibmmpc.nif 
IBMMPC_nif3 = ibmmpc.nif 
IBMMPC_nif4 » ibmmpc.nif 
IBMMPC_nif5 = ibmmpc.nif 
IBMMPCjiifG = ibmmpc.nif 
IBMMPC_nif7 = ibatmpc.nif 
!BMMPC_nif8 = ibmmpc.nif 

[NETBIOS] 

DriverName » netbios$ 

ADAPTERS *> netbeui $,6 
ADAPTER1 = netbeui $.1 
ADAPTER2 “ netbeui $.2 
ADAPTER3 = netbeui $.3 

; only four adapters may be initialized here - that's the NB39 interface 



[netbeui _ni f] 

DriverName » netbeui $ 

Bindings = I BMMPCjii f , I BMMPC nif2,IBMMPC nif3,IBMMPC nif4, 
IBMMPC_ni f5, IBMMPC_ni f6, IB»iPC_ni f7, 1 BMMPC_ni f8 

; the Bindings statement must go on a single line 

ETHERAND TYPE = "I" 

USEADDRREV * “YES" 

0S2TRACEHASK = 0x6 
SESSIONS = 254 
NCBS = 254 
NAMES = 42 
SELECTORS = 15 
USEMAXDATA6RAM = “NO" 

ADAPTRATE = 1686 
WINDOWERRORS = 0 
MAXDATARCV = 4352 
TI = 30888 
T1 = 1888 
T2 = 288 
MAXIN = 1 
MAXOUT « 1 

NETBIOSTIMEOUT = 2888 
NETB10SRETRIES = 3 
NAMECACHE = I860 
RNDOPTION = 1 
PIGGYBACKACKS = 1 
DATAGRAMPACKETS = 18 
PACKETS = 338 
LOOPPACKETS = 8 
PIPELINE = 5 
MAXTRANSMITS «= 6 
MINTRANSMITS = 2 
DLCRETRIES = 18 
FCPRIORITY = 5 
NETFLAGS * 8x1888 

[IBWiPCni f] 

DriverName = IBMMPC$ 

MaxTransmits = 31 
MaxTxFrameSize « 18888 
MinRcvBuffs = 28 
SizNorkBuf = 2848 
Multi castNum = 16 
EnableTxEoflnt = "YES" 

Enet28UTP = "NO" 

EnableHiPriTx = "NO" 

HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[IBMMPC_nif2] 

DriverName = IBMMPC$ 

MaxTransmits = 31 
MaxTxFrameSize = 18888 
MinRcvBuffs = 28 
SizWorkBuf = 2848 
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Multi castNum = 16 
EnableTxEoflnt * "YES" 
Enet28UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[IBMMPC_nif3] 

DriverNaiae = IBMMPC$ 
MaxTransmits =31 
MaxTxFratneSize = 18606 
MinRcvBuffs = 26 
SizWorkBuf = 2648 
Multi castNum = 16 
EnableTxEoflnt = "YES" 
Enet26UTP = “NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[IBMMPC_nif4] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFratneSize = 18080 
MinRcvBuffs « 20 
SizWorkBuf = 2048 
Multi castNum = 16 
EnableTxEoflnt = "YES" 
Enet28UTP = "NO" 
EnableHiPriTx = "NO” 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[ 1 BMMPC_ni f 5] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFratneSize = 18668 
MinRcvBuffs » 20 
SizWorkBuf = 2048 
Mul ti castNum = 16 
EnableTxEoflnt = "YES" 
Enet20UTP = t'NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[IBMMPC_nif6] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFratneSize = 18008 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
Multi castNum = 16 
EnableTxEoflnt = "YES" 
Enet28UTP = “NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[IBMMPC_nif7] 

DriverName = IBMMPCJ 
MaxTransmits = 31 
MaxTxFraneSize = 18080 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
Multi castNum = 16 
EnableTxEoflnt = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 
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[IBMMPC_nif8] 



DriverName = IBMMPCJ 
MaxTransraits = 31 
MaxTxFrameSize = 18688 
MinRcvBuffs = 28 
SizWorkBuf = 2848 
Multi castNum = 16 
EnableTxEoflnt = "YES" 

Enet28UTP = “NO" 

EnableHiPriTx = “NO" 

HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

The following lines are extracted from the LANTRAN.LOG file to reflect what 
messages will be logged when the Adapter and Protocol Services device drivers 
are initialized, when a configuration as shown above is being used: 

LT88873: FFST/2 is installed but is not started. LANTRAN.LOG is being 
IBM OS/2 LANMSGOO [11/83/95] 2.81 is loaded and operational. 

IBM OS/2 LAN Protocol Manager 

IBM - OS/2 Socket/MPTS Common Transport Semantics 

IBM OS/2 NETBEUI 5.88.8 

NETBEUI: Using a 32-bit data segment. 

Installing NETWKSTA.288 Version 5.8. IBM LAN Redirector (Nov 86, 1995) 

IBM OS/2 NETBIOS 4.8 

Adapter 8 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

Adapter 1 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

Adapter 2 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

Adapter 3 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

NETBIOS 4.8 is loaded and operational. 

IBM Streamer Family adapter NDIS device driver Version 4.61.88 
Initialization proceeding for section IBMMPC_NIF in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_N1F2 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC~NIF3 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF4 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF5 in PROTOCOL.INI 
Initialization proceeding for section 1BMMPC NIF6 in PROTOCOL.INI 
Initialization proceeding for section IBMMPCJIF7 in PROTOCOL.INI 
Initialization proceeding for section 1BMMPC_NIF8 in PROTOCOL.INI 
IBM LANVBD is loaded and operational. 

IBM OS/2 LAN Netbind 

Slot 3A: IBM Streamer Family adapter universal address is 88885a6c672c 

Slot 3A: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 3B: IBM Streamer Family adapter universal address is 88885a6c872d 

Slot 3B: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 4A: IBM Streamer Family adapter universal address is 88885a6c68a8 

Slot 4A: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 4B: IBM Streamer Family adapter universal address is 68895a6c88a9 

Slot 4B: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 6A: IBM Streamer Family adapter universal address is 68685a6cdlla 

Slot 6A: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 6B: IBM Streamer Family adapter universal address is 68685a6cdllb 

Slot 6B: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 7A: IBM Streamer Family adapter universal address is 68885ale4772 

Slot 7A: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 7B: IBM Streamer Family adapter universal address is 88685ale4773 

Slot 7B: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

The following lines are extracted from the IBMLAN.INI file to reflect what 
statements must be configured to support the configuration as shown above: 

[networks] 

netl = NETBEUI $, 8, LM18, 181,226,14 
net2 = NETBEUI $,1,LM18, 101,228,14 
net3 = NETBEU I $ , 2 , LM18 , 181 , 228 , 14 
net4 = NETBEUI $, 3, LM10, 181,228,14 
net5 = NETBEUI$,4,LM18, 181,226, 14 
net6 = NETBEUI$,5,LM18, 181,228, 14 
net7 = NETBEU1$,6,LM18, 181,228, 14 
net8 = NETBEUI!, 7, LM18, 181, 228, 14 



[requester] 



wrknets = netl,net2,net3,net4,net5,net6,net7,net8 
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[server] 



srvnets = netl,net2,net3,net4,net5,net6,net7,net8 



4.4 Useful Adapter and Protocol Services Applets 

Adapter and Protocol Services provides additional utility programs that can be 
very helpful in assisting the planning, configuration and problem-determination 
processes of an OS/2 Warp Server system. These programs are contained in the 
MPTSAPLT.ZIP file in the \CID\SERVER\IBMLS\IBM500N5\APPLETS directory on 
the OS/2 Warp Server CD-ROM. To install the programs, unzip that file into any 
directory on your hard drive that is included in the PATH= statement in 
CONFIG.SYS. 

This section describes some of the applets programs; a complete description is 
provided in the MPTS Configuration Guide online book on the OS/2 Warp Server 
desktop. You can find it by opening the Information folder, then LAN Services 
File and Print folder. 

NB64K Utility: This program checks a given NetBIOS configuration for the 
amount of memory that will be used and whether that amount will be within 
certain limits, as described in “Calculating Memory Requirements for Adapter 
and Protocol Services” on page 137. Figure 107 shows the NB64K program 
performing a check on the NETBEUI default parameters: 



NETBEUI 64k Boundary Checker vl.G 



| 254 | 
| 42 | 
| 255 | 
| 15 1 
[ 10 1 
| 8 | 



Commands (NCBS) « 

Names * 

Packets * 

Selectors ** 

Datagram Packets x 

Loop Packets x 

Overhead 
Total 



64 


16256 bytes 


76 


3192 bytes 


108 


27540 bytes 


10 


150 bytes 


124 


1240 bytes 


148 


11B4 bytes 




7732 bytes 


•- 


57294 bytes 



Calculate 




Exit 




Help 



{<-) Copyright 1814 Corp. AH rights reserved 



Figure 107. NB64K Utility 

NBJDSTAT Utility: This program can be used to display the status of the 
NetBIOS protocol on any of the four adapters that can be used with the NB30 
interface. A search for specific application names can be performed, such as 
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DB2/2 and RFC NetBIOS names. The example below shows the output of a 
possible status of all parameters for one instance of the NetBIOS protocol: 



NBJDSTAT V2.ee 
Copyright IBM 1992-1994 



Return Code from NCB. STATUS 6x6 

Universal Adapter Address 89EACE5A6888 

Software release number 4 

Reserved field 6 

Software Number 48FF. .Netbios 4. 8.. Token Ring 

Reporting period in minutes (since NCB reset).. 1448 

Number of FRKR frames received 6 

Number of FRMR frames transmitted 6 

Number of I frames received in error..... 6 

Number of aborted transmissions 8 

Number of successfully transmitted packets 7586 

Number of successfully received packets 49894 

Number of I frames transmitted in error 6 

Times a buffer was not present 6 

Number of times OLC tl expired 6 

Number of times OLC ti expired 732 

-—Extended status table— 

Dir init bring up error 8 

Dir open adapter error 8 

Latest network status 8 

Latest adapter check 6 

Latest pc detected error 8 

Latest operational cmd error. 8 

CCB rc 8 

Line error 8 

Internal error 8 

Burst errors 8 

ARI fci delimiter 8 

Abort delimiter 8 

Resveredl 8 

Lost frame 8 

Receive congestion 8 

Frame copy error 8 

Frequency error 8 

Token error 8 

Reserved2 8 

DMA bus error 8 

DMA parity error 8 

Local address 88885ACEEA89 

Number of Free NCBs 217 

Configured NCB maximum 225 

Maximum NCBs 225 

Local station busy count 8 

Maximum datagram packet 512 

Number of pending sessions 7 

Configured session maximum 138 

Maximum sessions 138 

Maximum session packet 4168 

Number of names in table 7 



Name 

MURLI 

8x4d55524c492826282828282828282888 


Name # 
882 


Status 
84 Unique 


Registered name 


MURLI V 

8x4d55524c492828282828282828282883 


883 


84 Unique 


Registered name 


ITSCAUS 

8x49545343415553282828282828282888 


884 


84 Group 


Registered name 


NQSPM2.MURLI8 

8x4e5153584d322e4d55524c4938888888 


885 


84 Unique 


Registered name 


MURLI 

8x4d55524c492828282828282626282826 


886 


64 Unique 


Registered name 


NO- ACTIVE. SPM2 

6x4e512e4143544956452e53584d326888 


887 


84 Group 


Registered name 


A948R2 V 


888 


84 Unique 


Registered name 



8x41393438523228282828282828282883 



The NBJDSTAT program can be used with the following options: 
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NBJDSTAT V2.00 
Copyright IBM 1992-1994 



Usage inbjdstat remote_name options 

remote_name: NETBIOS name to find(length: 16 characters [case sensitive]) 

If the name is less than 16 characters, blanks(0x20) are appended. 

* specifies local name, 
options: 

/a specifies adapter to use (default:©) - valid:©, 1,2, 3 
/ h :intrepet value as hex value and append to remote name 
example: SERVER1 /h20 

entire remote name may be specified as hex value 
examp 1 e : /h41555320202020202020202020202020 
/m :to make the name as IBM LS messenger name 
/n :to append 0x00 to the name up to 16 characters 
/q :to make the name as IBM LS requester name 
/v :to make the name as IBM LS server name 
/rxy:to make the name as IBM DB2/2 requester name 
x can be: s(sql name); i (interrupt name) 
y can be: ©(adapter 0); 1 (adapter 1) 

/sxy:to make the name as IBM DB2/2 server name 
if x: is c(catcher name)) 
y can be: ©(adapter 0); 1 (adapter 1) 
if x: is b( call back name) 

y can be: p(primary adapter); s(secondary adapter) 

NETPING Utility: This program can be used to query NetBIOS names on a 
network to check if a server system or partner application is actually active. Any 
of the four adapters that are supported by the NB30 interface can be used with a 
NETPING command. A search for specific application names can be performed, 
such as DB2/2 NetBIOS names. The example below shows a search for the 
name W4602S00: 



. 



NETPING V2.00 
Copyright IBM 1992-1994 



Finding the name "W4602S00 " in the network ... 

0123456789ABCDEF 

Name Type : UNIQUE 
MAC Address : 0800 5a6c 072c 
Route : e30 <- 011 <- 01b 

Target is here 

You are here ~ 

v ^ 



Figure 108. NETPING Utility 

The NETPING program can be used with the following options: 

NETPING V2.00 
Copyright IBM 1992-1994 



Userage:netping name options 

name:NETBIOS name to find(length: 16 characters [case sensitive]) 
If the name is less than 16 characters, blanks(0x20) 
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will be used to fill the name up to 16 characters, 
options: 

/ a : specifies adapter to use (defaults) 
valid adapter: 0,1, 2,3 

/m :to make the name as IBM LS messenger name 
/n :to append 0x00 to the name up to 16 characters 
/q :to make the name as IBM LS requester name 
/v :to make the name as IBM LS server name 
/rxy:to make the name as IBM DB2/2 requester name 
x can be: s(sql name); i (interrupt name) 
y can be: ©(adapter 0); 1 (adapter 1) 

/sxy:to make the name as IBM DB2/2 server name 
if x: is c(catcher name)) 
y can be: ©(adapter 0); 1 (adapter 1) 
if x: is b(callback name) 

y can be: p(primary adapter); s(secondary adapter) 

MAPNAME Utility: This program encodes and decodes NetBIOS names to and 
from names that can be used with the TCP/IP Domain Name System, as 
specified in RFCs 1001/1002. Please see “Storing NetBIOS Names on the Domain 
Nameserver” on page 266 on how to effectively use the MAPNAME program. 



4.5 NetWare Requester for OS/2 

OS/2 Warp Server provides the OS/2 requester program and protocols to access 
Novell NetWare servers and other systems that are using NetWare protocols in 
the network. It is, however, the purpose of this section to introduce the network 
protocols that the NetWare Requester is using, not to describe the NetWare 
Requester itself or any of its functions. 

Whereas Adapter and Protocol Services is an implementation of the NDIS 
architecture, Novell and Apple have jointly developed their own solution for 
multiprotocol networked environments - The Open Data-Link Interface (ODI). 

Figure 109 on page 158 illustrates ODI in relation to the OSI Model and the four 
main components of ODI. These are: 

• Network Protocol Drivers - (similar to NDIS protocol drivers) 

• Link Support Layer (LSL) - (similar in some respects to the NDIS interface) 

• Multiple Link Interface Driver (MLID) - (similar to NDIS MAC driver) 

• Control File - NET. CFG 
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Figure 109. ODI Stack 



By default, the NetWare Requester would run on an ODI stack. The normal 
NetWare protocol driver is IPX, for which there is no NDIS protocol driver 
available. However, it is not possible to have both an NDIS MAC driver and an 
ODI MUD loaded simultaneously for the same adapter. So, it is not possible, for 
example, to run the NetWare Requester on a full ODI stack and File and Print 
Sharing Services on an NDIS stack at the same time. 

To run the NetWare Requester over the NDIS interface, IBM has developed a 
special driver: ODI2NDI (or ODI to NDIS). This driver may be loaded from the 
Adapter and Protocol Services configuration panel like any protocol driver. 
ODI2NDI provides an interface to the ODI stack so that the NetWare protocol 
drivers are able to use the NDIS interface and to coexist with NDIS protocol 
drivers. Figure 110 on page 159 shows the protocol stacks in use when the 
NetWare Requester is coexisting with the IBM LAN requester. Please observe 
that the ODI2NDI driver, which appears to the NDIS interface as a protocol driver, 
appears to the ODI stack as an adapter driver (MUD). 
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Figure 1 10. NetWare Requester for OS/2 



Installing NetWare Requester Support on OS/2 Warp Server 

When you want to install the NetWare Requester on an OS/2 Warp Server 
system, you have to select the NetWare File Services Gateway option on the 
installation panel of File and Print Sharing Services. The NetWare Requester will 
always need to coexist with an application which uses an NDIS protocol stack. 
(Unless you are doing an Easy Install and the NetWare Requester is the only 
LAN application that you are installing). Because of this, the OS/2 Warp Server 
installation will automatically install and configure the ODI2NDI driver for you. 



4.6 NetWare NetBIOS Emulation 

MPTS allows the configuration of Novell's NetBIOS emulator program (IPXNB) 
that is provided with the NetWare Requester. IPXNB provides an LM10 NetBIOS 
interface that may be used by workstations running NetBIOS applications that 
support this interface, such as File and Print Sharing Services. This capability is 
extremely useful for customers who have multi-segment networks connected by 
IPX routers or those who already use IPX as the standard protocol on their 
networks and do not wish to introduce additional protocols. 

Figure 111 on page 160 shows an example scenario with both NetWare and 
NetBIOS protocols being used and NetWare Requester installed on a server. In 
this example, workstation A is able to access File and Print Sharing Services 
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resources on server B on the local LAN segment via NetBIOS, and the OS/2 
Warp Server (C) on the remote LAN segment across the IPX network via 
IPXBEUI. In addition, it is able to use the services provided by NetWare 
Requester to access local and remote NetWare servers via the native IPX 
protocol. 



OS/2 Warp Server *B" y 

- native NetBIOS 

Q 



OS/2 Warp Server "C" 

- native NetBIOS 

- NetWare Requester 

• NetBIOS over IPX (IPXBEUI) 



LAN Client "D” Wm / 

- native NetBIOS 




LAN Client "A" 

- native NetBIOS 

- NetWare Requester 

- NetBIOS over IPX 

OS/2 Warp Server Client 
OS/2 Warp Connect 
OS/2 LAN Requester 



Figure 111. IPXBEUI Coexistence 



Figure 112 on page 161 shows the active protocol stacks with the NetWare 
NetBIOS emulator loaded. 
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Figure 1 12. NetBIOS over IPX Protocol Stack 



Configuring NetWare NetBIOS Emulation 

The following steps are a guideline for configuring the NetWare NetBIOS 
emulation. 

1. Install the NetWare File and Print Gateway Services with File and Print 
Sharing Services. 

2. To configure the NetWare NetBIOS emulation, start the Install program from 
the NetWare File and Print Gateway Services folder. 

• Select Configuration and This Workstation (accept the default path for the 
NET.CFG file) 

• Select Edit. Figure 113 on page 162 shows the panel for configuring the 
NET.CFG file 

• Select NetWare NetBIOS 
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NET.CFG Options: 
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Reasons to configure 
Sample NET.CFG file 
Format of NET.CFG options 
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fi 
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Daemon Configuration 
message timeout number 
Link Driver 
dma 
frame 
Int 
mem 

node address 
port 



Current NET.CFG File Contents: 

NETWARE NETBIOS 
COMMANDS 95 
NAMES 21 
SESSIONS 58 



Save 






Cancel 






NET.CFG Option Information: 

Type the desired NET.CFG options In the Current NET.CFG 
File Contents box. A NET.CFG file Is not created by default. 
If a NET.CFG file could not be found, the Current NET.CFG 
File Contents box will be empty. 

The NET.CFG Options box In the upper left shows the proper 
syntax for each NET.CFG option. 



Usage 



Description 



Example 



Figure 113. NetWare Requester Configuration Panel 

The following NetWare NetBIOS emulation parameters determine the 
NetBIOS resources that are available for NetBIOS applications running over 
NetWare NetBIOS emulation: 

• COMMANDS 

(This corresponds with the NCBS parameter in the NETBEUI_NIF section 
of the x:\IBMCOM\PROTOCOL.INI file - default value is 32.) 

• NAMES 

(This corresponds with NAMES parameter in the NETBEUI_NIF section of 
the x:\IBMCOM\PROTOCOL.INI file - default value is 24.) 

• SESSIONS 

(This corresponds with SESSIONS parameter in the NETBEUI NIF section 
of the x:\IBMCOM\PROTOCOL.INI file - default value is 16.) 

3. Make the appropriate changes to the NetBIOS resource parameters 
according to the amount of NetBIOS resources needed to run the NetBIOS 
applications. 

4. Save the configuration, and close the NetWare Workstation for OS/2 
Installation Utility. 

Note: If the default values for COMMANDS, NAMES and SESSIONS are 
adequate, you do not need to carry out this configuration of the 
NET.CFG file. 

5. Select Configure LAN Adapters and Protocols, on the LAPS Configuration 
menu shown in Figure 101 on page 143. 

6. After selecting the appropriate network adapter, the following protocols need 
to be configured in order to properly run the NetWare NetBIOS emulation. 

• IBM Netware Requester Support (should have been added by the 
installation program) 

• Netware NetBIOS Emulation over IPX - IBM Netware Requester 
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The IBM Netware Requester Support enables protocol stacks that comply 
with the Novell Open Data Link Interface (ODI) specification to operate with 
network adapter drivers that comply with NDIS, up to NDIS Version 2.01. 

The Netware NetBIOS emulation over IPX modifies the PROTOCOL.INI file 
with the proper NetBIOS emulation over IPX sections in order to run NetBIOS 
applications over this NetBIOS emulation. 

7. After LAPS configuration is complete, select OK to save the configuration. 

Sample Configuration Files 

The following changes to the CONFIG.SYS file will have been made by the 
configuration of the NetWare NetBIOS emulator. Note that no changes to 
CONFIG.SYS are made by the MPTS configuration changes. 



REM — NetWare Requester statements BEGIN — 

SET NWLANGUAGE n ENGLISH 

DEVI CE«C:\NETWARE\LSl. SYS 

RUN=C: \NETWARE\DDAEMQN. EXE 

DEVICE-C: \IBMCOM\PROTOCOl\ODI2NDI . 0S2 

REM — ODI-Driver Files BEGIN — 

REM — ODI-Driver Files END — 

DEVICES: \NETWARE\RGUTE. SYS 

DEVICE=Cj\NETWARE\IPX.SYS 

DEVICES: \NETWARE\SPX. SYS 

RUN=C:\NETWARE\SPDAEMON. EXE 

rem DEVICE=C:\NETWARE\NMPIPE.SYS 

rem DEVICE a C:\NETWARE\NPSERVER.SYS 

rem RUN=C: \NETWARE\NPDAEMON.EXE 

DEVICES: \NETWARE\NWREQ. SYS 

IFS=C:\NETWARE\NWIFS. IFS 

RUN=C : \NETWARE\NWDAEMGN . EXE 

DEVICE=C: \NETWARE\NETBIOS. SYS 

RUN=C : \NETWARE\NBDAEMON . EXE 

DEVICE a C:\0S2\MD0S\LPTDD. SYS 

REM — NetWare Requester statements END — 



Figure 1 14. CONFIG.SYS with NetBIOS over IPX Configured (Extract) 



Figure 115 on page 164 shows a PROTOCOL.INI file from a workstation with 
NetBIOS over IPX configured. 
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[PROT_MAN] 



DRIVERNAME = PROTMANS 
[IBMLXCFG] 

ipxnbjiif = ipxnb.nif 
odi2ndi nif = odi2ndi.nif 
IBHTOK_nif = IBHTOK.NIF 

[NETBIOS] 

DriverName B netbiosS 

ADAPTERS = ipxnb$,B 

[ipxnbjiif] 

DriverName = ipxnb$ 

Bindings = IBHTOK_nif 

[odi2ndi_nif] 

DriverName = odi2ndi$ 

Bindings = IBHTOK nif 
NETADDRESS = "10005A88B1C9" 

TOKEN-RING = "yes" 

TOKEN-RING SNAP = "yes" 

ETHERNET 802.3 = “no" 

ETHERNET~802.2 = "no" 

ETHERNET_I I = "no" 

ETHERNET SNAP = "no" 

TRACE = 0x0 

[IBMTOK_nif] 

DriverName = IBHTOKS 
HAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XHITBUFS = 1 

Figure 1 15. PROTOCOL.INI with NetBIOS over IPX Configured 

Figure 116 shows an extract from the IBMLAN.INI for a IBM Peer for OS/2 
Version 1.0 workstation using NetBIOS over IPX. 



[networks] 

netl = ipxnb$,0,LH10, 34,50, 14 

; This information is read by the redirector at device initialization time. 

Figure 1 16. IBMLAN.INI Configured for NetBIOS over IPX 



NETWARE NETBIOS 
SESSIONS=50 
COMMANDS=40 
NAMES=15 

Figure 117. NET.CFG File for NetWare NetBIOS Emulator 
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Limitations When Using NetBIOS over IPX 

When using NetBIOS over IPX, the following has to be considered. 

An application using NetBIOS over IPX cannot communicate with another 
application using native NetBIOS. Even if applications are written to the NetBIOS 
programming interface, IPX protocol stacks cannot talk to NetBIOS protocol 
stacks. A partner must use the same communication protocol stack. 

Performance Considerations for IPXBEUI 

The NetBIOS emulation in the NetWare Requester is provided by the 
NETBIOS. SYS driver. The NetBIOS provided by Novell is called an emulator 
because it does not transmit NetBIOS packets on the network. Instead, NetBIOS 
packets are encapsulated in IPX packets, and the IPX packets are transmitted. 
The encapsulation process will impact performance of the File and Print Sharing 
Services. Also, bear in mind that the NetBIOS over IPX protocol does not have 
the same enhancements that have been specifically designed for routed 
networks as are available in the NetBIOS over TCP/IP protocol (see 6.4, 
“Reducing Broadcast Frames with TCPBEUI” on page 264). 

Native NetBIOS should always be considered as the protocol of choice whenever 
the network configuration allows. 



4.7 DOS and Windows LAN Applications on OS/2 

Adapter and Protocol Services also provide virtual device drivers to allow DOS 
and Windows applications to use the NetBIOS and IEEE 802.2 protocol services. 
The device drivers are loaded, when the following statements are contained in 
the CONFIG.SYS file: 

DEVICE=F:\IBMCOM\PROTOCOL\LANPDD.OS2 

DEVICE=F:\IBMCOM\PROTOCOL\LANVDD.OS2 

LANPDD.OS2 is the virtual IEEE 802.2 protocol driver, and LANVDD.OS2 is the 
virtual NetBIOS protocol driver for DOS and WIN-OS2 sessions. Both drivers are 
required to support any of these interfaces on DOS and WIN-OS2 sessions. 
These statements will be added by Adapter and Protocol Services automatically 
when you configure the NetBIOS or IEEE 802.2 protocol for at least one adapter. 

To reserve NetBIOS and IEEE 802.2 resources for a DOS or WIN-OS2 session, 
you have to include the LTSVCFG command in the AUTOEXEC.BAT file. This 
command takes to following parameters: 

LTSVCFG 

C = number of NetBIOS commands 

D = IEEE 802.2 direct station support 

N = number of NetBIOS names 

N1 = NetBIOS name #1 support 

S = number of NetBIOS sessions 

/ separator between multiple adapter configurations 

The resources specified with the LTSVCFG command are taken from the pool of 
resources that is defined in the PROTOCOL.INI file. 

The MPTS Configuration Guide online book provides configuration and 
application settings examples for the virtual device drivers. 
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4.8 Removing Adapter and Protocol Services 

Since Adapter and Protocol Services are a key feature of OS/2 Warp Server 
providing communications support to ail other components, it cannot be 
removed. 



4.9 Adapter and Protocol Support Related Publications 

This section provides the reader with a list of selected publications for further 
reading on the topics discussed in this chapter. 

• MPTS Configuration Guide, available online with OS/2 Warp Server 

• MPTS/2 Programmer's Guide, SI OH-9694 

• LAN Technical Reference IEEE802.2 and NetBIOS APIs, SC30-3587 
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Chapter 5. TCP/IP Services 



This chapter will describe the TCP/IP functions and services provided with OS/2 
Warp Server. It is our intention to concentrate on the new Dynamic IP 
capabilities of TCP/IP Services rather than on basic TCP/IP functions that are 
also contained in this release. We will, however, provide a brief overview of 
base TCP/IP functions and configuration at the beginning of this chapter. 

This chapter also contains a section about TCP/IP functions and services that are 
not included in OS/2 Warp Server, but are available from IBM as separate 
program products or can be purchased from other software vendors, and can be 
installed and used in addition to TCP/IP Services. Finally, this chapter provides 
examples of how OS/2 Warp Server and its TCP/IP Services can interoperate in 
a heterogeneous networking environment. 

For a more detailed discussion of basic TCP/IP components, and for a better 
understanding of protocols and applications that make up the TCP/IP 
communication environment, please refer to 5.18, “TCP/IP Related Publications” 
on page 258. 



5.1 Overview of TCP/IP Services 

The version of TCP/IP in the OS/2 Warp Server - TCP/IP V3.1 for OS/2 - is an 
enhanced version from OS/2 Warp Connect. What has been added are Dynamic 
IP services which will be documented in detail later in this chapter. There are 
also add-on packages that you can install on top of OS/2 Warp Server to add 
NFS, X Window System and Web server capability to TCP/IP Services, which will 
also be explained in 5.14, “Expanding OS/2 Warp Server TCP/IP Capabilities” on 
page 246. 

Figure 118 on page 168 shows an overview of TCP/IP Services, including 
functions from add-on packages. In the upper half, the TCP/IP applications, 
enablers and services that comprise TCP/IP Services are shown. Those 
applications, enablers, and services which can be added on top of TCP/IP 
Services show a dotted frame around the respective symbolic icon. The lower 
half of the figure illustrates the TCP/IP protocol stack that is supplied with OS/2 
Warp Server. 

As the word stack implies, the TCP/IP protocols can indeed be thought of as 
lying on top of each other because each is dependent on the function of others in 
that particular order. Most of the TCP/IP applications, however, require only one 
of the APIs, but are otherwise on the same level. We cannot show this in the 
diagram because the pages are not wide enough {or one would not be able to 
read it). There are some dependencies for applications as well: 

• Ultimail requires basic SMTP functions as provided with the Sendmail 
application. 

• NFS server requires the Portmapper application to be active in order to 
accept Remote Procedure Calls (RPCs). 
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Figure 118. OS/2 Warp Server TCP/IP Services and Add-on Kits - Overview 



New Functions of TCP/IP Services 

The new TCP/IP functions and services that come with OS/2 Warp Server are 
shown in the following table: 



Table 25. New Functions of TCP/IP Services 


System Component 


Description 


Dynamic Host Configuration 
Protocol (DHCP) server 


DHCP servers will provide the necessary 
information to allow DHCP clients on the network 
to automatically and dynamically obtain the 
addresses and configuration information about 
the network and about host operational 
parameters as specified by network 
administrators. 


Dynamic Domain Name 
Services (DDNS) server 


DDNS servers enable client hosts to dynamically 
register their name and address mappings in the 
DNS tables directly, rather than having an 
administrator manually perform the updates. 



We will discuss those features in separate sections later in this chapter. 
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Basic Functions and Services of TCP/IP 3.1 

The basic TCP/IP functions of TCP/IP Services include the following: 

• TCP/IP protocol stack providing for simultaneous LAN and dial-up Internet 
access {actually contained in Adapter and Protocol Services) 

• SLIP and PPP dial-up support 

• Online Internet registration and utilities for dial-up users 

• Remote login (Telnet, Telnet3270, Telnet5250) 

• File transfer (FTP, TFTP) 

• Remote program execution (Rexec, Rsh) 

• Remote printing (Lpr, Lpd, LprPortD) 

• Electronic mail including Multimedia support (SMTP, MIME, POP) 

• Internet client services (WebExplorer, Gopher, News Reader/2) 

• Network management agent (SNMPD) 

• Dynamic routing of IP datagrams using the Routing Information Protocol, RIP 
(RouteD) 

• Static automatic TCP/IP configuration at system start (Bootp) 

• Useful Tools (Ping, Netstat, Iptrace, Tracerte, Finger, RPCinfo) 

• REXX programming interface for Sockets and FTP APIs 

• Virtual TCP/IP stack and Winsock 1.1 API for DOS and Windows applications 

TCP/IP Services System Requirements 

This section lists the hard disk and memory requirements for TCP/IP Services, 
as well as the requirements for some of the additional packages. 

Fixed Disk Requirements 

Table 26 shows the recommended amount of fixed disk space to hold TCP/IP 
Services components, as shown in the disk space indicator window during 
installation. These requirements are to be added to the disk space that is 
required for OS/2 Warp Server base (about 86MB). 



Table 26 (Page 1 of 2). Fixed Disk Requirements for TCP/IP Services 


Services 


Required Disk 
(MB) 


TCP/IP 3.1 Base (includes IBM Internet Connection for OS/2, 
Ultimedia Mail 'Lite', DOS/Windows Access) 


18.4 


DHCP Server 


1.0 


DDNS Server 


1.6 


Internet Connection Server 


2.6 


NFS Kit 


1.5 


NFS TCP/IP CID Install 


0.3 


X Window System Server Kit 


12.0 


X Window System Client Runtime Services 


2.4 


X Window System Client Programmer's Toolkit 


1.5 


Programmer's Toolkit 


1.0 
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